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Preface 



This manual describes how to program the MCS-51 single-chip microcomputers in 
assembly language. It also describes the operating instructions for the MCS-51 Macro 
Assembler. 

The term MCS-51 refers to an entire family of single-chip microcomputers, all of 
which have the same basic processor design. They use the same instruction set, but 
differ slightly in memory-mapped special function registers and on-chip ROM and 
RAM. For example, the 8051 has 128 bytes of RAM; the 8044, 192 bytes; and the 
8052, 256 bytes.. 

The term 8051 will be used throughout this manual to refer to the entire MCS-51 
family. Cases that apply only to the 8051 processor will be specified explicitly. 

This book is intended as a reference, but it contains some instructional material as 
well. It is organized as follows: 

Chapter 1 — "Introduction," describes assembly language programming and 
provides an overview of the 8051 hardware. 

Chapter 2 — "Operands and Expressions," describes each operand class and 
discusses absolute and relocatable expressions. 

• Chapter 3 — "Instruction Set," completely describes the operation of each 
instruction in alphabetical order. 

• Chapter 4 — "Assembler Directives," describes how to define symbols and how to 
use all directives. 

Chapter 5 — "The Macro Processing Language," defines and describes the use of 
the Macro Processing Language. 

• Chapter 6 — "Assembler Operation and Controls," describes how to invoke the 
assembler and how to control assembler operation. 

• Chapter 7 — "Assembler Output: Error Messages and Listing File Format," 
describes how to interpret error messages and the listing file. 

Before you program one of the MCS-51 microcomputers, you should read the 
MCS-51 User's Manual. 

Related Literature 

The following list provides the manual title and order number for all Intel software 
development tools that run on DOS systems. Note that some manuals have two 
formats and two order numbers. One version of the manual is provided in a binder. 
This version is not sold separately; it can only be purchased when purchasing a 
software product. The second version, which has a soft cover, is sold separately. Use 
the soft cover number when ordering a manual separately. 
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Notational Conventions 

UPPERCASE Characters shown in uppercase must be entered in the order 

shown. Enter the command words as shown, or use a system- 
defined abbreviation. You may enter the characters in upper- 
case or lowercase. 

italic Italic indicates a meta symbol that may be replaced with an 

item that fulfills the rules for that symbol. The actual symbol 
may be any of the following: 

directory-name Is that portion of a pathname that acts as a file locator by 
identifying the device and/or directory containing the 
filename. 

filename Is a valid name for the part of a pathname that names a file. 

system-id Is a generic label placed on sample listings where an oper- 

ating system-dependent name would actually be printed. 

Is a generic label placed on sample listings where the version 
number of the product that produced the listing would 
actually be printed. 

Brackets indicate optional arguments or parameters. 

One and only one of the enclosed entries must be selected 
unless the field is also surrounded by brackets, in which case 
it is optional. 

At least one of the enclosed items must be selected unless the 
field is also surrounded by brackets, in which case it is 
optional. The items may be used in any order unless other- 
wise noted. 

The vertical bar separates options within brackets [ ] or 
braces < } . 

Ellipses indicate that the preceding argument or parameter 
may be repeated. 

The preceding item may be repeated, but each repetition must 
be separated by a comma. 
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Punctuation other than ellipses, braces, and brackets must be 
entered as shown. For example, the punctuation shown in the 
following command must be entered: 

SUBMIT PLM86CPR0GA.SRC . ' 9 SEPT 81 ' ) 

Indicates a carriage return. 
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Introduction 



This manual describes the MCS®-51 Macro Assembler and explains the process of 
developing software in assembly language for the MCS-51 family of processors. The 
8051 is the primary processor described in this manual. 

Assembly language programs translate directly into machine instructions which 
instruct the processor as to what operation it should perform. Therefore the 
assembly language programmer should be familiar with both the microcomputer 
architecture and assembly language. This chapter presents an overview of the 
MCS-51 Macro Assembler and how it is used, as well as a brief description of the 
805 1 architecture and hardware features. 



What Is an Assembler? 

An assembler is a software tool— a program— designed to simplify the task of 
writing computer programs. It performs the clerical task of translating symbolic 
code into executable object code. This object code may then be programmed into 
one of the MCS-51 processors and executed. If you have ever written a computer 
program directly in machine-recognizable form, such as binary or hexadecimal 
code, you will appreciate the advantages of programming in a symbolic assembly 
language. 

Assembly language operation codes (mnemonics) are easily remembered (MOV for 
move instructions, ADD for addition). You can also symbolically express addresses 
and values referenced in the operand field of instructions. Since you assign these 
names, you can make them as meaningful as the mnemonics for the instructions. 
For example, if your program must manipulate a date as data, you can assign it the 
symbolic name DATE. If your program contains a set of instructions used as a tim- 
ing loop ( a set of instructions executed repeatedly until a specific amount of time 
has passed), you can name the instruction group TIMER_LOOP. 

The assembly program has three constituent parts: 

Machine instructions 
Assembler directives 
Assembler controls 

A machine instruction is a machine code that can be executed by the machine. 
Detailed discussion of the machine instructions is presented in Chapter 3. 

Assembler directives are used to define the program structure and symbols, and 
generate non-executable code (data, messages, etc.). See Chapter 4 for details on all 
of the assembler directives. 

Assembler controls set the assembly modes and direct the assembly flow. Chapter 6 
contains a comprehensive guide to all the assembler controls. 



How to Develop a Program 

ASM51 enables the user to program in a modular fashion. The following paragraphs 
explain the basics of modular program development. 
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The Advantages of Modular Programming 

Many programs are too long or complex to write as a single unit. Programming 
becomes much simpler when the code is divided into small functional units. Modular 
programs are usually easier to code, debug, and change than monolithic programs. 

The modular approach to programming is similar to the design of hardware that 
contains numerous circuits. The device or program is logically divided into "black 
boxes" with specific inputs and outputs. Once the interfaces between the units have 
been defined, detailed design of each unit can proceed separately. 



Efficient Program Development 

Programs can be developed more quickly with the modular approach since small 
subprograms are easier to understand, design, and test than large programs. With 
the module inputs and outputs defined, the programmer can supply the needed input 
and verify the correctness of the module by examining the output. The separate 
modules are then linked and located into one program module. Finally, the com- 
pleted module is tested. 



Multiple Use of Subprograms 

Code written for one program is often useful in others. Modular programming 
allows these sections to be saved for future use. Because the code is relocatable, 
saved modules can be linked to any program which fulfills their input and output 
requirements. With monolithic programming, such sections of code are buried 
inside the program and are not so available for use by other programs. 



Ease of Debugging and Modifying 

Modular programs are generally easier to debug than monolithic programs. Because 
of the well-defined module interfaces of the program, problems can be isolated to 
specific modules. Once the faulty module has been identified, fixing the problem is 
considerably simpler. When a program must be modified, modular programming 
simplifies the job. You can link new or debugged modules to the existing program 
with the confidence that the rest of the program will not be changed. 



MCS 9 -51 Modular Program Development Process 

This section is a brief discussion of the program development process with the 
relocatable MCS-51 assembler (ASM51), Linker/Relocator (RL51), and code con- 
vertion programs. 



Segments, Modules, and Programs 

In the initial design stages, the tasks to be performed by the program are defined, 
and then partitioned into subprograms. Here are brief introductions to the kinds of 
subprograms used with the MCS-51 assembler and linker/relocator. 

A segment is a block of code or data memory. A segment may be relocatable or 
absolute. A relocatable segment has a name, type, and other attributes. Segments 
with the same name, from different modules, are considered part of the same seg- 
ment and are called "partial segments." Partial segments are combined into 
segments by RL5 1 . An absolute segment has no name and cannot be combined with 
other segments. 
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A module contains one or more segments or partial segments. A module has a name 
assigned by the user. The module definitions determine the scope of local symbols. 
An object file contains one or more modules. You can add modules to a file by simply 
appending another object file to that file. 

A program consists of a single absolute module, merging all absolute and 
relocatable segments from all input modules. 



Program Entry and Edit 

After the design is completed, the source code for each module is entered into disk 
file using a text editor. When errors are delected in the development process, ihe text 
editor may be used to make corrections in the source code. 



Assembly 

The assembler (ASM51) translates the source code into object code. The assembler 
produces an object file (relocatable, when at least one input segment is relocatable, 
or absolute), and a listing file showing the results of the assembly. (Figure l-l sum- 
marizes the assembly and the link and relocate outputs.) When the ASM51 invoca- 
tion contains the DEBUG control, the object file also receives the symbol table and 
other debug information for use in symbolic debugging of the program. 

Object File. The object file contains machine language instructions and data that 
can be loaded into memory for execution or interpretation. In addition, it contains 
control information governing the loading process. 

The assembler can produce object files in relocatable object code format. However, 
if the module contains only absolute segments and no external references, the object 
file resulting from assembly is absolute. It can be loaded without the need of the 
RL51 pass. 




I 





Figure 1-1. Assembler and Linker Relocator Outputs 



HI 
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Listing File. The listing file provides a permanent record of both the source program 
and the object code. The assembler also provides diagnostic messages in the listing 
file for syntax and other coding errors. For example, if you specify a 1 6-bit value for 
an instruction that can only use an eight-bit value, the assembler tells you that the 
value exceeds the permissible range. Chapter 7 describes the format of the listing file. 
In addition, you can also request a symbol table to be appended to the listing. The 
symbol table lists all the symbols and their attributes. 

Relocation and Linkage 

After assembly of all modules of the program, RL51 processes the object module 
files. The RL5I program assigns absolute memory locations to all the relocatable 
segments, combining segments with the same name and type. RL51 also resolves all 
references between modules. RL51 outputs an absolute object module file with the 
completed program, and a summary listing file showing the results of the link/ 
relocate process. 

Keeping Track of Files 

It is convenient to use the extensions of filenames to indicate the stage in the process 
represented by the contents of each file. Thus, source code files can use extensions 
like .SRC or .A5l (indicating that the code is for input to ASM51 ). Object code files 
receive the extension .OBJ by default, or the user can specify another extension. 
Executable files generally have no extension. Listing files can use .LST, the default 
extension given by the assembler. RL51 uses .M5l for the default summary listing 
file extension. 

Use caution with the extension .TMP, as many operating system utilities (including 
RL51 and LIB51) create temporary files with this extension. These utilities will 
overwrite your file if it has the same name and extension as the temporary files they 
create. 



Writing, Assembling, and Debugging an MCS 8 -51 Program 

There are several steps necessary to incorporate an MCS-51 microcomputer in your 
application. The flow chart in Figure 1-2 shows the steps involved in preparing the 
code. If you are developing hardware for your application in addition to the software, 
conslut the MCS®-51 Users Manual. 

Figure 1-3 shows an assembly listing of a sample program. The assembler was invoked 

by: 

ASM51 DEMQ.A51 
The output is: 

system-id MCS-51 MACROASSEMBLER, Vx.y 



ASSEMBLY COMPLETE, NO ERRORS FOUND 
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(FOR ABSOLUTE PROGRAMS) 
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ICE 1U -51 
(N-CIRCUIT 
EMULATOR 



Figure 1-2. MCS®-5t Program Development Process 







HCS-51 MACRO ASSEMBLER 8051-BASED MONITOR 

system-id MCS-51MACR0 ASSEMBLER. Vx.y 
OBJECT MODULE PLACED IN DEMO . OBJ 
ASSEMBLER INVOKED BY: ASM51 DEM . A51 



01/14/86 PAGE 



0000 020000 



0000 900000 



0003 120000 
0006 020000 



0000 1A 

0001 38303531 
0005 2D424153 
0009 4544204D 
OOOD 4F4E4954 
0011 4F522C20 
0015 56312E30 
0019 OD 

001A OA 
OOIA 





LINE 


SOURCE 








1 


STITLE 


(8051-BASED MONITOR) 




2 


;The main module of an 8051-based monitor 




3 
4 


.•Symbols definitions 




5 


PROG_S 


SEGMENT 


CODE .-Contains the executable p 






rogram 








6 


TABLE S 


SEGMENT 


CODE ;Containes tables and othe 






r constant data 






7 


CR 


EQU 


13 ; Carriage-Return character 






(ASCII) 




8 


LF 

I) 


EQU 


10 ; Line-Feed character (ASCI 




9 




EXTRN 


CODE(CONSOL_OUT, MONITOR) ;Defir. 






ed elsewhere 






10 










11 


;The main program 




12 




CSEG 


AT ;Skip interrupt vectors if 






any 






F 


13 




JMP START 




14 










15 




RSEG 


PROG_S 




16 


START: 






F 


17 




MOV 


DPTR,#SIGNON ; Print signon mess 






age 






P 


18 




CALL 


CONSOL OUT 


F 


19 




JMP 


MONITOR ; Enter the monitor 






ing loop 






20 










21 




RSEG 


TABLE S 




22 


SIGNON: 


DB 


LEN, 1 8051-BASED MONITOR, VI. 0', CR 



LEN 
ength 



; Compute message 1 







Figure 1-3. Sample Program Listing 
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MCS-51 MACRO ASSEMBLER 8051-BASED MONITOR 
SYMBOL TABLE LISTING 



NAME 


T 


Y P E 


V A L U 


E 


CONSOL OUT 


C 


ADDR 






CR . . . . 




NUMB 


O00DH 


A 


LEN. . . . 




NUMB 


001AH 


A 


LF . . . . 




NUMB 


OOOAH 


A 


MONITOR. . 


C 


ADDR 






PROG S . . 


c 


SEG 


0009H 




SIGNON . . 


c 


ADDR 


O00OH 


R 


START . . . 


c 


ADDR 


OOOOH 


R 


TABLE S. . 


c 


SEG 


001BH 





attribut: 



REL=UNIT 
SEG=TABLE_S 
SEG=PROG_S 
REL-ONIT 



REGISTER BANK ( S ) USED: 
ASSEMBLY COMPLETE, NO ERRORS FOUND 




Figure 1-3. Sample Program Listing (Con'td.) 



Figure 1-3 shows the listing file of a simple module that is part of a larger program 
not shown here. A larger example is provided in Appendix H. 

The next step after the program is assembled by ASM51 is to combine all modules 
into one program using RL51. RL51 produces a summary listing file consisting of a 
memory map and a symbol table. (Refer to the MCS-51 Utilities User's Guide.) 

The next step in debugging your code is to program it into an EPROM 8751 and test 
it in a prototype environment. (Further testing could be done via ICE-51.) To program 
your code into an 8751, you must have a UPP connected to your Intellec system. For 
a complete description of how to use UPP and UPM, see Universal PROM Program- 
mer Reference Manual and Universal PROM Programmer User's Manual. 



Hardware Overview 

For complete hardware details on any member of the MCS-51 family, refer to 
Appendix L and the literature describing your processor. The major features of the 
8051 are 

• Resident 4K bytes of ROM or EPROM program memory (no program memory 
resident on 8031 ). expandable to 64K bytes 

• Resident 1 28 bytes of RAM memory, which includes four banks of eight general- 
purpose registers and a stack for subroutine and interrupt routine calls 

• 64K bytes of external RAM address space 

• 16-bit Program Counter giving direct access to 64K bytes of memory 
Eight-bit stack pointer that can be set to any address in on-chip RAM 

• Two programmable 16-bit timers/counters 
Programmable full duplex serial I/O ports 

• Four eight-bit bidirectional parallel I/O ports 

• Timer and I/O interrupts with two levels of priority 

• 111 instructions with 51 basic functions (including memory to memory move) 
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Boolean functions with 128 software flags, numerous hardware flags, and 12 bit- 
operand instructions 

• Arithmetic and logic unit that includes add, subtract, multiply, and divide arith- 
metic functions, as well as and, or, exclusive or, and complement logic functions. 

Figure 1-4 is a block diagram of the 8051 processor. It shows the data paths and 
principal functional units accessible to the programmer. 



^7J_J [ 



— FT^F 



SENSE AMPS 




5~5 



-MH— H 



T 



TOPQ LATCH 



Figure 1-4. 8051 Block Diagram 
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Memory Addresses 

The 8051 has five address spaces: 

• Code address space — 64K, of which 4K are on-chip (except for the 8031 which 
has no on-chip ROM). 

• Directly addressable internal data address space — 128 bytes of RAM (0 — 127) 
and 128-byte hardware register address space (128 — 255; only 20 addresses are 
used); accessible by direct addressing. 

• Indirectly addressable internal data address space — 128 bytes (0 — 127), all of 
which is accessible by indirect addressing. 

External data address space — up to 64K of off-chip memory added by the user. 

• Bit address space — shares locations accessible in the data address space; acces- 
sible by direct addressing. 

The code address space, internal data address space (including both the directly and 
indirectly addressable space and the bit address space), and external data space cor- 
respond to three physically distinct memories, and are addressed by different 
machine instructions. This is an important distinction that is a key to understanding 
how to program the 805 1 . 

When you specify in an operand to an instruction a symbol with the wrong attribute, 
ASM-51 generates an error message to warn you of the inconsistency. Chapters 2 
and 3 show what segment type attribute is expected in each instruction, and Chapter 
4 describes how to define a symbol with any of the segment type attributes. 

Figure 1-5 shows the code address space (usually ROM), and the external data 
address space (usually RAM). Off-chip ROM and RAM can be tailored to use all or 
part of the address space to better reflect the needs of your application. You can 
access data in ROM and off-chip RAM with the MOVC and MOVX instructions 
respectively. 
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Figure 1-5. MCS®-51 Code Address Space and External Data Address Space 
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To the programmer, there is no distinction between on-chip and off-chip code. The 
16-bit program counter freely addresses on- and off-chip code memory with no 
change in instruction fetch time. 

Figure 1-6 shows the data address space containing the bit address space. The data 
address space contains four banks of general-purpose registers in the low 32 bytes 
(0 — 1FH). In addition to the 128 bytes of RAM, the 805 l's hardware registers are 
mapped to data addresses. The addresses from 128 to 255 are reserved for these 
registers, but not all of those addresses have hardware registers mapped to them. 
These reserved addresses are unusable. 

When programming the 8051 and using indirect addressing, the user can access on- 
chip RAM from to 127. 
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Figure 1-6. MCS®-51 Data Address Space and Bit Address Space 



Data Units 

The 8051 manipulates data in four basic units — bits, nibbles (four bits), bytes, and 
words (16 bits). Figure 1-7 illustrates the MCS-51 data units. 

The most common data unit used is a byte; all of the internal data paths are eight 
bits wide, and the code memory, the data memory, and the external data memory 
store and return data in byte units. However, there are many instructions that test 
and manipulate single bits. Bits can be set, cleared, complemented, logically combined 
with the carry flag, and tested for jumps. The nibble (BCD packed digit) is less 
commonly used in the 8051, but BCD arithmetic can be performed without conver- 
sion to binary representation. 
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Figure 1-7. MCS»-51 Data Units 

Instructions that use 1 6-bit addresses deal with the Data Pointer (DPTR, a 1 6-bit 
register) and the Program Counter (jumps and subroutine calls). However, with the 
add with carry (ADDC) and subtract with borrow (SUBB) instructions, software 
implementation of 1 6-bit arithmetic is relatively easy. 

Arithmetic and Logic Functions 

The arithmetic functions include: 

• ADD — signed two's complement addition 

ADDC — signed two's complement addition with carry 

• SUBB — signed two's complement subtraction with borrow 

• DA — adjust two packed BCD digits after addition 

• MUL — unsigned integer multiplication 

• DIV— unsigned integer division 

• INC — signed two's complement increment 

• DEC — signed two's complement decrement 

The accumulator receives the result of ADD, ADDC, SUBB, and DA functions. The 
accumulator receives partial result from MUL and DIV. DEC and INC can be applied 
to all byte operands, including the accumulator. 

The logical functions include: 

• ANL — logical and on each bit between two bytes or two bits 
CPL — logical complement of each bit within a byte or a single bit 

• ORL — logical or on each bit between two bytes or two bits 

• XRL — logical exclusive or on each bit between two bytes 
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The accumulator usually receives the result of the byte functions, and the carry flag 
usually receives the result of the bit functions, but some instructions place the result 
in a specified byte or bit in the data address space. 

The instructions shown above are described in Chapter 3. 



General-Purpose Registers 

The 8051 has four banks of eight one-byte general-purpose registers. They are located 
in the first 32 bytes of on-chip RAM (00H — I FH). You can access the registers of 
the currently active bank through their special assembler symbols (R0. Rl, R2, R3, 
R4, R5, R6, and R7). To change the active bank you modify the register bank select 
bits (RSO and RSI) contained in the program status word (PSW, described in table 
1-3). Table 1-1 below shows the bank selected for all values of RSO and RSI. 



Table 1-1. Register Bank Selection 



RS1 


RSO 


Bank 


Memory Locations 











00H-07H 





1 


1 


08H-0FH 


1 





2 


10H-17H 


1 


1 


3 


18H-1FH 



Registers R0 and Rl can be used for indirect addressing within the on-chip RAM. 
Each register is capable of addressing 256 bytes but the indirect addressing is limited 
by the physical range of the internal R AM . R0 and R 1 also can address the external 
data space. 



The Stack 

The stack is located in on-chip RAM. It is a last-in-first-out (LIFO) storage mecha- 
nism used to hold the Program Counter during interrupts and subroutine calls. You 
can also use it to store and return data, especially the PSW, with the POP and PUSH 
instructions. The Stack Pointer contains the address of the top of the stack. 

The Stack Pointer (SP) is an eight-bit register that may contain any address in on- 
chip RAM memory. However, on the 8051 it should never exceed 127. If it does, all 
data pushed is lost. A pop, when the SP is greater than 127, returns invalid data. 

The SP always contains the address of the last byte pushed on the stack. On powerup 
(Reset) it is set to 07H, so the first byte pushed on the stack after reset will be at 
location 08H. This location is compatible with the 8048's stack. Most programs 
developed for the 8051 will reset the bottom of the stack by changing the contents of 
the SP before using the stack, because 08H — 1FH is the area reserved for several of 
the 805 l's general-purpose-register banks. The following instruction causes the next 
byte pushed on the stack to be placed at location 100. 



MOVE SP.#99 



; Initialize stack to start at location 100 
; The hardware increments the SP 
; BEFORE a push 
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Symbolically Addressable Hardware Registers 

Each programmable register is accessible through a numeric data address, but the 
assembler supplies a predefined symbol that should be used instead of the register's 
numeric address. Table 1-2 identifies each hardware register, its numeric address, 
and its predefined symbol. 



Table 1-2. Symbolically Addressable Hardware Registers for the 805 1 



Predefined 


Data 




Symbol 


Address 




ACC 


EOH 


ACCUMULATOR (Data address of A) 


B 


FOH 


MULTIPLICATION REGISTER 


DPH 


83 H 


DATA POINTER (high byte) 


DPL 


82H 


DATA POINTER (low byte) 


IE 


A8H 


INTERRUPT ENABLE 


IP 


B8H 


INTERRUPT PRIORITY 


PO 


80 H 


PORTO 


P1 


90H 


PORT 1 


P2 


AOH 


PORT 2 


P3 


BOH 


PORT 3 


PSW 


DOH 


PROGRAM STATUS WORD 


SBUF 


99H 


SERIAL PORT BUFFER 


SCON 


98H 


SERIAL PORT CONTROLLER 


SP 


81 H 


STACK POINTER 


TCON 


88 H 


TIMER CONTROL 


THO 


8CH 


TIMER (high byte) 


TH1 


8DH 


TIMER 1 (high byte) 


TLO 


8AH 


TIMER (low byte) 


TL1 


8BH 


TIMER 1 (low byte) 


TMOD 


89 H 


TIMER MODE 



The predefined symbols given in table I -2 stand for the on-chip data addresses of the 
hardware registers. In many cases the only access to these registers is through these 
data addresses. However, some of the registers have an identity both as a special 
assembler symbol and as a data address symbol (e.g., both ACC and A stand for the 
accumulator), but even though these symbols may be semantically the same, they are 
syntactically different. For example, 

ADD A, #27 

is a valid instruction to add 27 to the contents of the accumulator, but 

ADD ACC, #27 

is invalid and will cause an error, because there is no form of ADD taking a data 
address as the destination (ACC specifies a data address). The differences become 
even more subtle in some assembly instructions where both symbols are valid but 
assemble into different machine instructions: 



MOVA,#27 
MOV ACC,#27 



; assembles into a 2 byte instruction 
; assembles into a 3 byte instruction 
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Chapter 2 describes the syntax for all instruction operands, and Chapter 3 describes 
the operands expected in each instruction. 

Because the hardware registers are mapped to data addresses, there is no need for 
special I/O or control instructions. For example. 



moves a copy of the input data at Port 2 to the accumulator. To output a character 
on the Serial I/O port (after preparing SCON), simply move the character into the 
Serial port buffer (SBUF): 

MOVSBUF.r?' 



Many of the hardware control registers are also bit addressable. The flags contained 
in them can be accessed with a bit address as well as through the byte address shown 
above. One way to do this is through the bit selector (.). For example, to access the 
bit in the accumulator, you might specify ACC.O. 

Bit addressing allows the same simplicity in testing and modifying control and status 
flags as was shown above with addressable registers. For example, to start Timer 
running, set the run flag to l via its bit address (SETB TCON.4). 

Throughout the remainder of this chapter, several programmable features, includ- 
ing predefined bit addresses of status and control flags, are discussed. To use these 
features, you simply modify the corresponding address as if it were a RAM location. 

The Program Status Word 

The Program Status Word (PSW) contains several status bits that reflect the state of 
the 8051. Figure 1-8 shows the predefined bit address symbol, the bit position, and 
meaning of each bit in the PSW. 



MOV A.P2 



Bit Addressing 




PSW 7 

CARRY FLAG RECEIVES CARRY OUT 
FROM BIT 7 OF ALU OPERANDS 



PSW 

PARITY OF ACCUMULATOR SET 
BY HARDWARE TO 1 IF IT CONTAINS 
AN ODD NUMBER OF Is. OTHERWISE 
IT IS RESET TO 



AUXILIARY CARRY FLAG RECEIVES 
CARRY OUT FROM BIT 3 OF 
ADDITION OPERANOS 



PSW 1 

USER DEFINABLE FLAG 



PSW s 

GENERAL PURPOSE STATUS FLAG 



PS* 2. 

OVERFLOW FLAG SET BY 
ARITHMETIC OPERATIONS 



PSW 4 

REGISTER BANK SELECT BIT 1 



PSW 3 

REGISTER BANK SELECT BIT 





Figure 1-8. Bit Descriptions of Program Status Word 
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Timer and Counter 

The 805 1 has two independently programmable timers. They feature a 16-bit counter 
and are controlled by two registers, timer mode (TMOD) and timer control (TCON). 
Figure 1-9 shows the predefined bit address symbols, the positions and meanings of 
the bits in TCON. (For a complete description of the timer see the MCS®-5I User's 
Manual. ) 



I TFt TR1 TFO TRO 



Figure 1-9. Bit Descriptions of TCON 



I/O 



The 805 1 has four eight-bit I/O ports; each bit in the ports corresponds to a specific 
pin on the chip. All four ports are buffered by a port latch, and they are addressable 
through a data address (as a byte) or eight bit addresses (as a set of bits). As noted 
earlier, this removes the need for special I/O instructions. The numeric data address 
and the predefined symbol for each port is shown below: 



or( Predefined Data 

Symbol Address 

PO 80H 

1 P1 90H 

2 P2 AOH 

3 P3 BOH 



Port and Port 2 are used for external program and external data addressing. Port 
also receives the input data from off-chip addressing. If off-chip memory is noi 
implemented, then ports and 2 are bidirectional I/O ports. Port 1 is a general pur- 
pose bidirectional I/O port. 

Port 3 contains the external interrupt pins, the external timer, the external data 
memory read and write enables, and the serial I/O port transmit and receive pins. 
The bits that correspond to these pins are individually addressable via predefined bit 
address symbols. Figure 1-10 shows the meaning of each bit, its position in Port 3, 
and its predefined bit address symbol. 

If the external interrupts, external data addressing, and serial I/O features of the 
805 1 are not used, Port 3 can function as a bidirectional I/O port. 
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Figure 1-10. Bit Descriptions for Port 3 



Serial I/O Port 



The serial I/O port permits I/O expansion using UART protocols. The serial I/O 
port is controlled by Serial Port Controller (SCON), a register that is both bit 
addressable and byte addressable. Figure 1-11 shows the predefined bit address 
symbols, positions and meanings of the bits in SCON. For complete details of Serial 
I/O port control see the MCS®-51 User's Manual. 



I SMG SMI SM2 REN TBS RB 



,-4 
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Figure 1-11. Bit Descriptions tor Serial Port Control 

Interrupt Control 

There are two registers that control timer and I/O interrupts and priorities. They are 
IE (Interrupt Enable) and IP (Interrupt Priority). When the interrupt enable bit for 
a device is l, it can interrupt the processor. The 805 1 does not respond to an interrupt 
until the instruction being executed has been completed (this can be as long as four 
cycles). 

When it does respond, the 8051's hardware disables interrupts of the same or lesser 
priority and makes a subroutine call to the code location designated for the inter- 
rupting device. Typically, that location contains a jump to a longer service routine. 
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The instruction RETI must be used to return trom a service routine, in order to 
re-enable interrupts. The reserved locations, the predefined labels, and the 
associated interrupt devices are listed below. These labels may be used to aid the 
placement of I/O routines in code memory. 



Label 


Location 


Interrupting Device 


RESET 


00H 


Power on Reset (First instruction executed on power up.) 


EXTIO 


03 H 


External interruptO 


TIMERO 


OBH 


Timer 


EXTI1 


13H 


External interrupt 1 


TIMER1 


1BH 


Timer 1 


SINT 


23H 


Serial I/O port 



The 8051 has two levels of interrupt priority (0 and 1). Figure 1-12 shows the 
predefined bit address symbol, the position and the device associated with each bit 
contained in IE and IP. A level 1 priority device can interrupt a level service 
routine, but a level interrupt will not affect a level 1 service routine. Interrupts on 
the same level are disabled. 



PS PT1 PX1 PTO PXO I 



IP. 7 f 



t IP O 



PRIORITY OF EXTERNAL INTERRUPT 



PRIORITY OF TIMER INTERRUPT 



PRIORITY OF EXTERNAL INTERRUPT 1 



PRIORITY OF SERIAL PORT INTERRUPT 



t_, 



ENABLE EXTERNAL INTERRUPT 



ENABLE TIMER INTERRUPT 



ENABLE EXTERNAL INTERRUPT 1 



_ 



_ 



Figure 1-12. Bit Descriptions for Interrupt Enable and Interrupt Priority 
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RGSGt 

On reset all of the registers in the 8051 assume an initial value. Table 1-3 shows these 
initial values. This will always be the state of the chip when your code begins 
execution. You can use these initial values or reinitialize them as necessary in your 
program. 



Table 1-3. State of the 8051 after Power-up 



Register 


Value 


Accumulator 


00 H 


Multiplication Register 


00 H 


Data Pointer 


0000 H 


Interrupt Enable 


00 H 


Interrupt Priority 


00 H 


PortO 


0FFH 


Port 1 


0FFH 


Port 2 


0FFH 


Port 3 


0FFH 


Program Counter 


0000H 


Program Status Word 


00 H 


Serial Port Control 


00 H 


Serial I/O Buffer 


undefined 


Stack Pointer 


07H 


Timer Control 


00 H 


Timer Mode 


00H 


Timer Counter 


0000H 


Timer 1 Counter 


0000 H 



NOTE 

The PC is always set to on reset, thus the first instruction executed in a 
program is at ROM location 0. The contents of RAM memorv is unpre- 
dictable at reset. 



Operands and Expressions 



This chapter discusses the operand types used by ASM51. It describes their use and 
some of the ways you can specify them in your program. The latter part of the 
chapter deals with expressing numbers and using expressions. 

There are two terms used throughout this chapter that require some definition: 
Assembly-time expressions and RL-time expressions. Assembly-time expressions are 
those expressions evaluated at assembly; they are absolute expressions. RL-time 
expressions are those evaluated at the time of relocation; they are relocatable expres- 
sions that are made absolute by RL5 1 . 



Operands 

The general form of all instruction lines is as follows: 

[label :]Mnemonic [operand] [.operand] ]. operand] [-.comment] 

The number of operands and the type of operands expected depend entirely on the 
mnemonic. Operands serve to further define the operation implied by a mnemonic, 
and they identify the parts of the machine affected by the instruction. 

All operands fall into one of six classes: 

• Special Assembler Symbols 

• Indirect Addresses 

• Immediate Data 

• Data Addresses (on-chip) 

• Bit Addresses 

• Code Addresses 

A special assembler symbol is a specific reserved word required as the operand in an 
instruction. 

Indirect addresses use the contents of a register to specify a data address. 

The remaining operand types (immediate data, data addresses, bit addresses, and 
code addresses) are numeric expressions. They may be specified symbolically, but 
they must evaluate to a number. If the expression can be evaluated completely at 
assembly time, it is called an absolute expression; if not, it is called a relocatable 
expression. The range permitted for a numeric operand depends on the instruction 
with which it is used. The operand can be made up of predefined or user-defined 
symbols, numbers, and assembly-time operators. 

As described in Chapter 1, there are five address spaces on the 8051. The 
corresponding segment type is given in parentheses. 

• Directly addressable data address space (DATA) 

• Bit address space (BIT) 

• External data address space (XDATA) 

• Code address space (CODE) 

• Indirectly addressable data space (IDATA) 
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In some cases the same numeric value is a valid address for all five address spaces. 
To help avoid logic errors in your program, ASM5 1 attaches a segment type and per- 
forms type checking for instruction operands (and arguments to assembler direc- 
tives), that address these segments. For example, in jump instructions the assembler 
checks that the operand, the target address, has a segment type CODE. Possible seg- 
ment types are DATA, BIT, CODE, XDATA, and IDATA. Chapter 4 describes 
how to define symbols with different segment types. 



Special Assembler Symbols 



The assembler reserves several symbols to designate specific registers as operands. A 
special assembler symbol is encoded in the opcode byte, as opposed to a data address 
that is encoded in an operand byte. Table 2- 1 lists these symbols and describes the 
hardware register each represents. 



If the definition of an instruction requires one of these symbols, only that special 
symbol can be used. However, you can, with the SET and EQU directives, define 
other symbols to stand for the accumulator (A) or the working registers (R0....R7). 
Symbols so defined may not be forward referenced in an instruction operand. You 
cannot use a special assembler symbol for any other purpose in an instruction 
operand or directive argument. Several examples of instructions that use these sym- 
bols are shown below. 



INC DPTR ;increment the entire 16-bit contents of the Data Pointer by 1 

SETBC :set the Carry flag to 1 

JMP 8 A + DPTR ;add the contents of the accumulator to the contents of the data 
:pointer and jump to that address 



In addition to these symbols, the assembler also recognizes the location counter sym- 
bol ($), described in Chapter 4, and the register address symbols ARO, ARl 

AR7, described with the USING directive in Chapter 4. 



Table 2-1 . Special Assembler Symbols 



Special Symbol 


Meaning 


A 


Accumulator 


RO, R1, R2, R3. 
R4.R5, R6, R7 


Stands for the 8 general registers in the currently active bank (4 
register banks available) 


DPTR 


Data pointer: a 16-bit register used for addressing in the code 
address space and the external address space 


PC 


Program counter: a 16-bit register that contains the address of the 
next instruction to be executed 


C 


Carry flag receives ALU carry out and borrow from bit 7 of the 
operands 


AB 


Accumulator/B register pair used in MULand DIV instructions 
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Indirect Addressing 

An indirect address operand identifies a register that contains the address of a memory 
location to be used in the operation. The actual location affected will depend on the 
contents of the register when the instruction is executed. In most instructions indirect 
addresses affect on-chip RAM. However, the MOVC and MOVX instructions use 
an indirect address operand to address code memory and external data memory, 
respectively. 

In on-chip indirect addressing (the IDATA space), either register or register 1 of 
the active register bank can be specified as an indirect address operand. The commer- 
cial at sign (@) followed by the register's special symbol (RO or Rl), or a symbol 
defined to stand for the register's special symbol, indicates indirect addressing. If you 
indirectly access a non-existent address (e.g., beyond byte 192 on the 8044 proces- 
sor), the program continues with no indication of the error. If it is a source operand, 
a byte containing undefined data is returned. If it is a destination operand, the data 
is lost. 

The following examples show several uses of indirect addressing. 

ADD A.@R1 ; add the contents of the on-chip RAM location addressed by 

; register 1 to the accumulator 

INC @R0 ; increment the contents of the on-chip RAM location addressed 

; by register 

MOVX @DPTR,A ; move the contents of the accumulator to the off-chip memory 
; location addressed by the data pointer 



Immediate Data 

An immediate data operand is a numeric expression that, when assembled, is encoded 
as part of the machine instruction. The pound sign (#) immediately before the expres- 
sion indicates that it is an immediate data operand. The numeric expression must be 
a valid assembly-time expression or RL-time expression. 

The assembler represents all numeric expressions in 16 bits, and converts to the 
appropriate form for instruction encoding. 

Most instructions require the value of the immediate data to fit into a byte. The low 
order byte of the assembler's 16-bit internal representation is used. The assembler 
permits a numeric expression range of values from —256 to +255. These values all 
have a homogeneous high order byte (i.e., all ones or all zeroes) when represented in 
16 bits. The low order byte of the assembler's 16-bit internal representation is used. 
Note that since only the lower order byte is taken as the result of the expression, the 
sign information, i.e., the higher order byte, is lost. 

The immediate data operands that accept a 16-bit value can use any value represent- 
able by the assembler. Immediate data operands do not require any specific segment 
type. XDATA and IDATA type operands can be specified only as immediate 
operands; i.e., you have to load these addresses first into a register and then access 
them. 
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The following examples show several ways of specifying the immediate data operand. 

MOV A,#0E0H ; place the hex constant EO in the accumulator 

MOV DPTR,#0A14FH ; this is the only instruction that uses a 16-bit immediate data 

; operand 

ANL A,#128 ; mask out all but the high order bit of the accumulator 

; (128-base 10) - 10000000 (base 2) 



MOV R0,#IDATA_SYM 



; Load R0 with IDATA symbol for later access 



Data Addressing 

The data address operand is a numeric expression that evaluates to one of the first 
1 28 on-chip byte addresses or one of the hardware register addresses. The low-order 
byte of the assembler's 16-bit internal representation is used. This permits a range 
from —256 to +255. Note that since only the lower order byte is taken as the result 
of the expression, the sign information (i.e.. the higher order byte) is lost. Instructions 
that use the data address operand require that the symbol or expression specified be 
either of segment type DATA or be a typeless number. (Symbols are discussed below 
under expression evaluation.) 

The direct data addresses from to 127 access the 805 l's on-chip RAM space, while 
the addresses from 128 to 255 access the hardware registers. Not all of the addresses 
in the hardware register space are defined. Figure 2-1 shows the meaningful addresses 
and their predefined data address names for the 8051 chip. Refer to Appendix L for 
the addresses of the other MCS-51 family chips. 

If you read from a reserved address, undefined data will be returned. If you write to 
a reserved address, the data will be lost. Using these pecularities in your program 
may result in incompatibility with future versions of the chip. Note that using indirect 
addressing for locations above 127 will access IDATA space rather than hardware 
register space. 



HIGH 

ORDER 

DIGIT 



LOW ORDER DIGIT OF ADDRESS 



937,12 

Figure 2-1. Hardware Register Address Area for 8051 
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The following examples show several ways of specifying data addresses. 

MOV P1,A ;move the contents of the accumulator to the predefined data address 90 

;(base16) poru 

ORL A, 20*5 .logical OR of accumulator with location 100 (base 10) uses an 
;assembly-time operator multiply 

INC COUNT ;increment the location identified by the symbol COUNT 

INC 32 increment location 32(base 10) in memory 



Bit Addressing 

A bit address represents a bit-addressable location either in the internal RAM (bytes 
32 through 47) or a hardware bit. There are two ways to represent a bit address in 
an operand. 

1. You can specify the byte that contains the bit with a DATA type address, and 
single out the particular bit in that byte with the bit selector, period (.), followed 
by a bit identifier (0-7). For example, FLAGS.3, 40.5, 21H.0 and ACC.7 are 
valid uses of the bit selector. You can use an assembly-time expression to express 
the byte address or the bit identifier. The assembler will translate this to the 
correct absolute or relocatable value. Note that only certain bytes in the on-chip 
address space are bit addressable. If the data address is specified by a relocatable 
expression, the referenced segment must have B1TADDRESSABLE relocation 
type (see Chapter 6 for segments). The expression that specifies the bit address 
must be absolute. 

2. You specify the bit address explicitly. The expression now represents the bit 
address in the bit space (it must have a BIT segment type). Note that bit addresses 
through 127 map onto bytes 32 through 47 of the on-chip RAM, and bits 128 
through 255 map onto the bit addressable locations of the hardware register space 
(not all the locations are defined). 

If the bit address is used in the context of BIT directive, then the first expression 
must be an absolute or simple relocatable expression. If used in a machine instruction 
where a bit address is expected, then a general relocatable expression is also allowed. 

Figures 2-2a and 2-2b show the bits assigned to each numeric bit address. 

The following examples show several ways of specifying bits. 

SETB TR1 ; set the predefined bit address TR1 (timer 1 run flag) 

SETB ALARM ; set the user defined bit ALARM 

SETB 88H.6 ; Set bit 6 of location 88H (timer 1 run flag) 

CPL FLAGS. ON ; complement the bit ON of the byte FLAGS 

SETB 8EH ; set the bit address 8E(base 16) (timer 1 run flag) 

On the 805 1 chip, there are several bit addresses that are predefined as symbols that 
you can use in an operand. Table 2-2 shows these predefined bit addresses. You can 
also define your own bit address symbols with the BIT directive described in Chapter 
4 (see Appendix L for examples). 




Figure 2-2a. Bit Addressable Bytes in RAM 
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B FOH 

ACC EOH 

PSW DOH 
COH 

P3 BOH 

P2 AOH 

Pi 90H 

PO 80H 




F8H 
E8H 
D8H 
C8H 
B8H 
ASH 
98H 
88H 



SCON 
TCON 



™1L. 

Figure 2-2b. Bit Addressable Bytes in Hardware Register Address Area for 8051 
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Table 2-2. Predefined Bit Addresses for 8051 



Symbol 


Bit 
Position 


Bit 
Address 


Meaning 


CY 


PSW.7 


D7H 


Carry Flag 


AC 


PSW.6 


D6H 


Auxiliary Carry Flag 


FO 


PSW.5 


D5H 


FlagO 


RS1 


PSW.4 


D4H 


Register Bank Select Bit 1 


RSO 


PSW.3 


D3H 


Register Bank Select Bit 


ov 


PSW.2 


D2H 


Overflow Flag 


p 


PSW.O 


DOH 


Parity Flag 


I r 1 


TCON .7 


8FH 


Timer 1 Overflow Flag 


TR1 


TC0N.6 


8EH 


Timer 1 Run Control Bit 


TFO 


TCON. 5 


8DH 


Timer Overflow Flag 


TRO 


TCON. 4 


8CH 


Timer Run Control Bit 


IE1 


TCON. 3 


8BH 


Interrupt 1 Edge Flag 


IT1 


TCON. 2 


8AH 


Interrupt 1 Type Control Bit 


IE0 


TC0N.1 


89 H 


Interrupt Edge Flag 


ITO 


TCON.O 


88 H 


Interrupt Type Control Bit 


SMO 






serial Mooe control Bit u 


SM1 


SCON. 6 


9EH 


Serial Mode Control Bit 1 


SM2 


SCON. 5 


9DH 


Serial Mode Control Bit 2 


REN 


SCON. 4 


9CH 


Receiver Enable 


TB8 


SCON. 3 


9BH 


Transmit Bit 8 


RB8 


SCON. 2 


9AH 


Receive Bit 8 


Tl 


SC0N.1 


99 H 


Transmit Interrupt Flag 


Rl 


oCUN .U 


98 H 


Receive Interrupt Flag 


EA 


IE. 7 


AFH 


Enable All Interrupts 


ES 


IE. 4 


ACH 


Enable Serial Port Interrupt 


ET1 


IE. 3 


ABH 


Enable Timer 1 Interrupt 


EX1 


IE. 2 


AAH 


Enable External Interrupt 1 


ETO 


IE.1 


A9H 


Enable TimerO Interrupt 


EXO 


IE.0 


A8H 


Enable External Interrupt 


RD 


P3.7 


B7H 


Read Data for External Memory 


WR 


P3.6 


B6H 


Write Data for External Memory 


T1 


P3.5 


B5H 


Timer/Counter 1 External Flag 


TO 


P3.4 


B4H 


Timer/Counter External Flag 


INT1 


P3.3 


B3H 


Interrupt 1 Input Pin 


INTO 


P3.2 


B2H 


Interrupt Input Pin 


TXD 


P3.1 


B1 H 


Serial Port Transmit Pin 


RXD 


P3.0 


BOH 


Serial Port Receive Pin 


PS 


IP. 4 


BCH 


Priority of Serial Port Interrupt 


PT1 


IP. 3 


BBH 


Priority of Timer 1 Interrupt 


PX1 


IP. 2 


BAH 


Priority of External Interrupt 1 


PTO 


IP.1 


B9H 


Priority of TimerO 


PXO 


IP.O 


B8H 


Priority of External Interrupt 



Code Addressing 

Code addresses are either absolute expressions whose values are within to 65,535, 
or relocatable expressions with a segment type of CODE. There are three types of 
instructions that require a code address in their operands. They are relative jumps, 
in-block (2K page) jumps or calls, and long jumps or calls. 
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The difference between each type is the range of values that the code address 
operand may assume. All three expect an expression which evaluates to a CODE 
type address (an absolute expression between and 65,535 or a relocatable 
operand), but if you specify a relative jump or an in-block jump, only a small subset 
of all possible code addresses is valid. Instructions that use the code address operand 
require that the symbol or expression specified be either of segment type CODE or a 
typeless number. (Symbols and labels are discussed below under absolute expression 
evaluation.) 

Relative Jumps (SJMP) and Conditional Jumps 

The code address in a relative jump must be close to the relative jump instruction 
itself. The range is from — 128 to + 127 bytes from the first byte of the instruction 
that follows the relative jump. 

The assembler takes the specified code address and computes a relative offset that is 
encoded as an eight-bit two's complement number. That offset is added to the contents 
of the program counter (PC) when the jump is made; but since the PC is always 
incremented to the next instruction before the jump is executed, the range is computed 
from the succeeding instruction. 

When you use a relative jump in your code, you must use an expression that evaluates 
to the code address of the jump destination. The assembler does all the offset compu- 
tations. If the address is out of range, the assembler will issue an error message. 

In-Block Jumps and Calls (AJMP and ACALL) 

The code address operand to an in-block jump or call is an expression that is evalu- 
ated and then encoded in the instruction. The low order 1 1 bits of the destination 
address are placed in the opcode byte and the operand byte. When the jump or call 
is executed, the I l-bit page address replaces the low order 1 1 bits of the program 
counter. This permits a range of 2048 bytes, or anywhere within the current block. 
The current block is thus determined by the high order 5 bits of the address of the 
next instruction. If the operand is not in the current block, this is an assembler (or 
RL51) error. 

Note that if the in-block jump or call is the last instruction in a block, the high order 
bits of the program counter change when incremented to address the next instruction; 
thus the jump will be made within that new block. 

Long Jumps and Calls (LJMP and LCALL) 

The code address operand to a long jump or call is an expression that will be evalu- 
ated and then encoded as a 1 6-bit value in the instruction by the assembler, or, if the 
expression is relocatable, by RL51. All 16 bits of the program counter are replaced 
by this new value when the jump or call is executed. Since 16 bits are used, any value 
representable by the assembler will be acceptable (0 — 65,535). 

The following examples show each type of instruction that calls for a code address. 

SJMP LABEL ; Jump to LABEL (relative offset LABEL must be within - 1 28 and + 1 27 
; of instruction that follows SJMP 

ACALL SORT ; Call subroutine labelled SORT (SORT must be an address within the 
; current 2K page) 

LJMP EXIT ; Long jump; the label or symbol EXIT must be defined somewhere in 
; the program. 
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Generic Jump and Call (JMP and CALL) 

The assembler provides two instruction mnemonics that do not represent a specific 
opcode. They are JMP and CALL. JMP may assemble to ACALL or LCALL. 
These generic mnemonics will always evaluate to an instruction, not necessarily the 
shortest, that will reach the specified code address operand. 

This is an effective tool to use during program development, since sections of code 
change drastically in size with each development cycle. (See Chapter 3 for a complete 
description of both generic jumps.) Note that the assembler decision may not be 
optimal. For example, if the code address is a forward reference, the assembler will 
generate a long jump although an in-block or short jump may be possible. 



Assembly-Time Expression Evaluation 

An expression is a combination of numbers, character strings, symbols, and 
operators that evaluate to a single 16-digit binary number. Except for some direc- 
tives, all expressions can use forward references (symbols that have not been defined 
at that point in the program) and any of the assembly-time operators. 



Specifying Numbers 

You can specify numbers in hexadecimal (base 16), decimal (base 10), octal (base 8), 
and binary (base 2). The default representation, used when no base designation is 
given, is decimal. Table 2-3 below shows the digits of each numbering system and 
the base designation character for each system (upper- and lowercase characters are 
permitted). 

The only limitation to the range of numbers is that they must be representable within 
16 binary digits. 

Table 2-4 gives several examples of number representation in each of the number 
systems. 



Table 2-3. Assembly Language Number Representation 



Number System 


Base Designator 


Digits in Order of Value 


Binary 
Octal 
Decimal 
Hexadecimal 


B 

OorQ 

D or (nothing) 
H 


0, 1 

0, 1, 2, 3, 4, 5, 6, 7 

0, 1, 2, 3, 4, 5, 6, 7, 8, 9 

0, 1, 2, 3, 4, 5, 6, 7, 
8, 9, A, B, C, D, E, F 



Table 2-4. Examples of Number Representation 



base 16 


base 10 


base 8 


base 2 


50 H 


80 


120O 


01010000B 


0ACH* 


172D 


254Q 


10101100B 


01 h 


1 


1Q 


1B 


10H 


16d 


20Q 


10000B 



•A hexadecimal number must start with a decimal digit; is used here. 
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ASM51 Number Representation 

Internally, ASM51 represents all numeric values with 16 bits. When ASM5I encoun- 
ters a number in an expression, it immediately converts it to 1 6-bit binary represen- 
tation. Numbers cannot be greater than 65,535. Appendix H describes conversion of 
positive numbers to binary representation. 

Negative numbers (specified by the unary operator " — ") are represented in two's 
complement notation. There are two steps to converting a positive binary number to 
a negative (two's complement) number. 

0000 0000 0010 0000B = 20H 

1111 1111 1101 1111 -Not20H 1. Complement each bit in the number. 

1111 1111 1110 0000 =(Not20H) + 1 2. Add 1 to the complement. 
1111 1111 1110 O0OOB - -20H 
To convert back simply perform the same two steps again. 

Although two's complement notation is used. ASMS I docs not convert these numbers 
for comparisons. Therefore, large positive numbers have the same representation as 
small negative numbers (e.g., — I = 65,535). Table 2-5 shows number interpretation 
at assembly-time and at program execution-time. 



Table 2-5. Interpretations of Number Representation 



Number Characteristic 


Assembly-Time 
Expression Evaluation 


Program Execution 
Arithmetic 


Base Representation 
Range 

Evaluates To: 

Internal Notation 

Signed/Unsigned 
Arithmetic 


Binary, Octal, Decimal, 
or Hexadecimal 

0—65,535 

16 Bits 

Two s Complement 
Unsigned 


Binary, Octal, Decimal, 
or Hexadecimal 

User Controlled 

User Interpretation 

Two's Complement 

User Interpretation 



Character Strings in Expressions 

The MCS-51 assembler allows you to use ASCII characters in expressions. Each 
character stands for a byte containing that character's ASCII code. (Appendix H 
contains a table of the ASCII character codes.) That byte can then be treated as a 
numeric value in an expression. In general, two characters or less are permitted in a 
string (only the DB directive accepts character strings longer than two characters). In 
a one character string the high byte is filled with 0's. With a two character string, the 
first character's ASCII value is placed in the high order byte, and the second 
character's value is placed in the low order byte. 

All character strings must be surrounded by the single quote character ('). To 
incorporate the single quote character into the string, place two single quote 
characters side-by-side in a string. For example, V is a string of two characters: a 
lower case "Z" and the single quote character. 
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The ability to use character strings in an expression offers many possibilities to enhance 
the readability of your code. Below are two examples of how character strings can be 
used in expressions. 



TEST: CJNE A,#'X',SKIP 
JMP FOUND 
SKIP: MOVA,@R1 
INC R1 

DJNZ R2.TEST 



If A contains 'X' then fall through 
Otherwise, jump to skip and 
Move next character into accumulator 
Change R1 to point to next character 
JUMP to TEST if there are still more 
characters to test 



MOV A.SBUF ; Move character in serial port buffer 

; to accumulator 

SUBB A,#'0' ; Subtract '0' from character just read 

; this returns binary value of the digit 

NOTE 

A corollary of this notation for character strings is the null string — two single 
quotes surrounding no characters (side-by-side). When the null character 
string is used in an expression it evaluates to 0, but when used as an item in 
the expression list of a DB directive it will evaluate to nothing and will not 
initiate memory. (See Chapter 4 for an example.) 



Use of Symbols 

The assembler has several kinds of symbols available to the programmer. They may 
stand for registers, segments, numbers, and memory addresses. They allow a 
programmer to enhance the readability of his code. 

Symbols are defined by four attributes: 

• Type — register, segment, number, address 

• Segment Type— DATA, BIT, XDATA, CODE, IDATA 

• Scope — local, public, external 

• Value — register name, segment base address, constant value, symbol address 
(depending on type) 

Not all of these four attributes are valid combinations. 

The type attribute provides a common classification to the symbols: 

• Register — indicates symbols that were defined as such by EQU or SET directives 

• Segment -indicates symbols that were designated as relocatable segments 

• Number — indicates that the symbol represents a pure number and can be used 
in any expression. (It has no segment type.) 

• Address — indicates that the symbol represents a memory address. 

The segment type specifies, for segment symbols, the address space where the segment 
resides. For address type symbols, it specifies the way the symbol may be used (as a 
DATA address, BIT address, etc.). Usually it is identical to the address space in 
which the owning segment was defined. The only exception is for symbols defined as 
bits within a BITADDRESSABLE DATA type segment (see the BIT directive in 
Chapter 4). Such symbols have a BIT type. 

The scope attribute is valid for number and address type symbols. It specifies whether 
the symbol is local, public, or external. 
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The value attribute is defined with respect to the type of the symbol: 

• Register- the value is the name (in ASCII) of the register 

• Segment- the value is the base address (computed at RL-time) 

• Number — the value of the constant 

Address — for an absolute symbol, the value is the absolute address within the 
containing address space. For a relocatable address symbol, the value is the offset 
(in bits or bytes depending on the segment type) from the base of its owning 
segment. 

Once you have defined a symbol anywhere in your program (some expressions require 
that no forward references be used), you can use it in any numeric operand in the 
same way that you would use a constant, providing you respect segment type conven- 
tions. The segment type required for each numeric operand is described above. The 
creation of user-defined symbols is completely described in Chapter 4. 

Several predefined addresses are available for hardware registers and flags via the 
MOD51 control (see Chapter 6). Table 2-6 shows all of the predefined data address 
symbols and the values they represent. The bit address symbols have been listed earlier 
in table 2-2. 

Remember that these symbols evaluate to a data address and cannot be used in 
instructions that call for a special assembler symbol. 

ADD A, #5 ; This is a valid instruction. A is the special 

; assembler symbol required tor this operand 

ADD ACC,#5 ; This is an invalid instruction and will generate 

; an error message. ACC is an address and not 
; the special symbol required for the instruction 

There is an additional symbol that may be used in any numeric operand, the location 
counter ($). When you are using the location counter in an instruction's operand, it 



Table 2-6. Predefined Data Addresses for 805 1 



Symbol 


Hexadecimal 
Address 


Meaning 


ACC 


EO 


Accumulator 


B 


F0 


Multiplication Register 


DPH 


83 


Data Pointer (high byte) 


DPL 


82 


Data Pointer (low byte) 


IE 


A8 


Interrupt Enable 


IP 


B8 


Interrupt Priority 


PO 


80 


PortO 


PI 


90 


PorM 


P2 


AO 


Port 2 


P3 


BO 


Port 3 


PSW 


DO 


Program Status Word 


SBUF 


99 


Serial Port Buffer 


SCON 


98 


Serial Port Controller 


SP 


81 


Stack Pointer 


TCON 


88 


Timer Control 


THO 


8C 


Timer (high byte) 


TH1 


8D 


Timer 1 (high byte) 


TLO 


8A 


TimerO (low byte) 


TL1 


8B 


Timer 1 (low byte) 


TMOD 


89 


Timer Mode 
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will stand for the address of the first byte of the instruction currently being encoded. 
You can find a complete description of how to use and manipulate the location 
counter in Chapter 4, Assembler Directives. 

Using Operators in Expressions 

There are four classes of assembly-time operators: arithmetic, logical, special, and 
relational. All of them return a 16-bit value. Instruction operands that require only 8 
bits will receive the low order byte of the expression. The distinction between each 
class of operators is loosely defined. Since they may be used in the same expression, 
they work on the same type of data, and they return the same type of data. 

Arithmetic Operators 

Table 2-7 contains a list of all the arithmetic operators. 



Table 2-7. Arithmetic Assembly-Time Operators 



Operator 


Meaning 


+ 


Unary plus or add 




Unary minus or subtract 




Multiplication 


/ 


Integer division (discard remainder) 


MOD 


Modular division (discard quotient) 



The following examples all produce the same bit pattern in the low order byte 
(0011 0101B): 

+53 

27+26 

-203 

65-12 

2*25+3 multiplication is always executed before the addition 
160/3 

153 MOD 100 

Note that the MOD operator must be separated from its operands by at least one 
space or tab, or have the operands enclosed in parentheses. 

Logical Operators 

Table 2-8 contains a list of all logical operators. The logical operators perform their 
operation on each bit of their operands. 



Table 2-8. Logical Assembly-Time Operators 



Operator 


Meaning 


OR 


Full 16-bit OR 


AND 


Full 16-bit AND 


XOR 


Full 16-bit exclusive OR 


NOT 


Full 16-bit complement 



The following examples all produce the same eight-bit pattern in the low order byte 
(0011 0101B): 

0001 0001 B OR 00110100B 

01110101B AND 1 01 1 01 1 1B 

11000011B XOR 11110110B 

NOT 11001010B 
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Note that all logical operators must be separated from their operand by at least one 
space or tab, or have the operands enclosed in parentheses. 



Special Assembler Operators 

Table 2-9 contains a list of all special operators. 



Table 2-9 . Special Assembly-Time Operators 



Operator 


Meaning 


SHR 
SHL 
HIGH 
LOW 




16-bit shift right 
16-bit shift left 

Select the high order byte of operand 
Select the low order byte of operand 
Evaluate the contents of the parentheses first 


The following examples all produce the same eight-bit pattern in the low order byte 
(OOIl OIOIB): 


01AFH SHR 3 


Bits are shifted out the right end 
and is shifted into the left. 


HIGH(1135H SHL 8) 


Parentheses is required since HIGH 
has a greater precedence than SHL. 
Bits are shifted out the left and 
is shifted in the right. 


LOW 1 135H 


Without using the LOW operator, 
the high order byte would have 
caused an error in an eight-bit 
operand. 



Note SHR, SHL, HIGH, and LOW must be separated from their operands by at 
least one space or tab, or have the operands enclosed in parentheses. 



Relational Operators 

The relational operators differ from all of the other operators in that the result of a 
relational operation will always be either (False) or OFFFFH(True). Table 2-10 
contains a list of all the relational operators. 



Table 2-10. Relational Assembly-Time Operators 



Operator 


Meaning 


EQ = 


Equal 


NE <> 


Not equal 


LT < 


Less than 


LE <= 


Less than or equal to 


GT > 


Greater than 


GE >= 


Greater than or equal to 
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The following examples all will return TRUE (OFFFFH): 

27H EQ 39D 
27H <> 27D 
33 LT 34 
7 > 5 
16 GE 10H 

Note that the two-letter (mnemonic) form of the relational operator must be separated 
from its operand by at least one space or tab; the symbolic form does not. If the space 
or tab is not used, the operand must be enclosed in parentheses. 



Operator Precedence 

Every operator is given a precedence in order to define which operator is evaluated 
first in an expression. For example, the expression 3*5 + 1 could be interpreted as 16 
or 18 depending on whether the * or the + is evaluated first. The following list shows 
the precedence of the operators in descending order. 

• Parenthesized expression ( ) 

• HIGH, LOW 

• *, /, MOD, SHL, SHR 

• +, - unary and binary forms 

• EQ, NE, LT, LE, GT, GE, =, <>, <, <=, >, >= 

• NOT 

• AND 

• OR.XOR 

All operators on the same precedence level are evaluated from left to right in the 
expression. 



Segment Typing in Expressions 

Most expressions formed with assembly-time operators do not have a segment type, 
but some operations allow the expression to assume the segment type of a symbol 
used in the expression. The rules for expressions having a segment type are listed 
below. 

1. The result of a unary operation ( + , — , NOT, LOW, HIGH) will have the same 
segment type as that of its operand. 

2. The result of all binary operations except plus ( + ) and minus ( — ) will have no 
segment type (i.e., NUMBER). 

3. For a binary plus or minus operation, if only one of the operands has a segment 
type, then the result will have that segment type. If not, the result will have no 
segment type. 

This means that only memory address plus or minus a number (or a number plus or 
minus a number) gives a memory address. All other combinations produce a typeless 
value. For example, code-address + (data_address_l — data_address_2) produces a 
value which is a CODE address; (data_address_l — data_address_2) has no segment 
type. 
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Relocatable Expression Evaluation 

A relocatable expression is an expression that contains a relocatable or external refer- 
ence, called the "relocatable symbol." Such an expression cannot be completely 
evaluated at assembly time. The Relocator and Linker program (RL51 ) finalizes such 
expressions using its additional knowledge; i.e., where the relocatable segments and 
the public symbols are located. 

A relocatable expression may usually contain only one relocatable symbol. However, 
when subtracting ( — ) or comparing (>, EQ, etc.) relocatable symbols which refer 
to the same relocatable segment, the result is absolute quantity, and these symbols 
are not counted as relocatable. 

The relocatable symbol may be modified by adding or subtracting an absolute quantity 
(called offset). Thus the following forms result in valid relocatable expressions: 

relocatable.symbol + absolute_expression 
relocatable_symbol - absolute_expression 
absolute_expression + relocatable_symbol 

There are two types of relocatable expressions: simple relocatable expressions that 
can be used for symbol definition and code generation; and general relocatable 
expressions that can be used only in code generation. 

Simple Relocatable Expressions 

In simple relocatable expressions the relocatable symbol can represent only an address 
in a relocatable segment. External and segment symbols are not allowed. 

Simple relocatable expressions can be used in three contexts: 

1 . As an operand to the ORG statement. 

2. As an operand to the following symbol definition directives: EQU, SET, CODE, 
XDATA, IDATA, BIT. or the DATA directives. 

3. As an operand to a machine instruction or a data initialization directive (DB or 
DW). 

Examples: 
VALID 

REL1 + ABS1M0 
REL2 - ABS1 

REL1 + (REL2 - REL3) ... assuming REL2 and REL3 refer to the same segment 
INVALID 

(REL1 + ABS1)"10 ...relocatable quantity may not be multiplied 

EXT1 - ABS1 ...this is a general relocatable expression 

REL1 + REL2 - REL3 ...you cannot add relocatable symbols (REL1, REL2) 

General Relocatable Expressions 

General relocatable expressions can be used only in statements that generate code; 
i.e., as operands to machine instructions, or as items in a DB or DW directive. 

In this case the relocatable symbol may be a simple relocatable symbol (representing 
an address in a relocatable segment), a segment symbol (representing the base address 
of a relocatable segment), or an external symbol. 
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In addition, the relocatable expression may be prefixed by the LOW or the HIGH 
operator. 

Examples: 

VALID 

REL1 + ABSV10 
EXT1 - ABS1 
LOW(SEG1 + ABS1) 

INVALID 

(REL1 + ABS1)"tO ...relocatable quantity may not be multiplied 
EXT1 - REL1 ...you can add/subtract only absolute quantities 

LOW SEG1 + ABS1 ...LOW/HIGH may be applied only to the final relocatable expression (or 
to an absolute expression); the expression here is equivalent to (LOW 
SEG1) + ABS1 



Instruction Set 



This chapter contains complete documentation for all of the 8051 instructions. The 
instructions are listed in alphabetical order by mnemonic and operands. 

Introduction 

This chapter is designed to be used as a reference. Each instruction is documented 
using the same basic formal. The action performed by an instruction is defined in 
three ways. First, the operation is given in a short notation; the symbols used and 
their meanings are listed in the table below. The operation is then defined in a few 
sentences in the description section. Finally, an example is given showing all of the 
registers affected and their contents before and after the instruction. 

NOTE 

The only exception is that the program counter (PC) is not always shown. 
All instructions increment the PC by the number of bytes in the instruction. 
The "Example:" entry for most instructions do not show this increment by 
the PC. Only those instructions that directly affect the PC (e.g., JMP, 
ACALL, or RET) show the contents of the PC before and after execution. 

The list of notes that appears at the bottom of some instructions refer to side-effects 
(flags set and cleared and limitations of operands). The numbers refer to the notes 
tabulated at the end of this chapter. 

The "Operands:" entry for each instruction briefly indicates the range of values and 
segment type permitted in each operand. For a complete description of the limits of 
any operand see Chapter 2. In general, the operand's name will identify what section 
to consult. 

With one exception, the operands to 3 byte instructions are encoded in the same 
order as they appear in the source. Only the "Move Memory to Memory" instruc- 
tion is encoded with the second operand preceding the first. 



3-2 MCS -51 Macro Assembler 



The illustration below (figure 3-1) describes the meaning of each section of the 
instruction documentation. 



ADD 

Add Immediate Data 



Mnemonic: ADO 

Operands: A 

data 

Forms! AOD A I Sara 
8it Pattern 



! 



(A) - lAi + oata 



XTi 



DflBCfipliOn: Thi. i 
of the 

Eaampia ADD A *31*i A00 32H lo Kcumuuw 



Accumulator 

oT m . 



Figure 3-1. Format for Instruction Definitions 



Mnemonic: shows opcode mnemonic. It is shown in upper case, but upper or 
lower case characters are permitted. 

Operands: indicates range and type of operands permitted. 

Format: shows the format of the instruction, including the order of operands 
on the source line. 

Bit Pattern: indicates bit pattern in opcode and position of operands when 
encoded. Letters in the opcode's bit pattern vary with operand specified. 

Operation: symbolically defines the operation performed by the instruction. 
The symbols used in this entry are defined in table 3-1 . 

Bytes and Cycles: shows the number of bytes of code and the number of 
machine cycles used by the instruction. 

Flags: indicates any status flag that may be changed during the execution of 
the instruction. 

Description: is a brief prose description of the operation performed by the 
instruction. 

Example: shows an example instruction as it would appear in the source. It 
also shows the bit pattern of the encoded instruction, and the contents of all 
registers affected by the instruction, immediately before and after the instruc- 
tion is executed. 

The PC is incremented by all instructions, but only instructions that affect the 
PC as part of their operation show its contents in the example. 

Notes: indicates the notes on page 3-142 that pertain to the instruction. 
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Table 3-1 . Abbreviations and Notations Used 





Appn m n 1 ^ t r» r 

. \L L U 1 1 1 U HI I V 1 1 


AB 


RppKtpr Pair 


Q 


Multiplication Register 


bit address 


8051 bit address 


fjay& aUUi GOO 


1 1 -bit code address within 2K page 


i a m a vts ui loci 


8-hit 9 ' <; rnmnlpmpnt off^Pt 

O Ull i. O L.VJlllJJlCllltllL Ul 


c 


Carrv Flae 


LiUUtf aUUI Croo 


Ah^nhitp rnde aHHrps*; 

l \ UjuIUIV tUUv CI t-1 v<l 1 v 3 3 




Immediate data 


data address 


On-chip 8-bit RAM address 


DPTR 


Data pointer 


PC 


Prnoram C^niinfpr 

i ivjgiaiii v_ uunici 


Rr 


R ppi^tpr(r— 0-71 

l\vglolVl \J i ) 


SP 


^tncW nninfpr 

■ J l CI ^ r\ Lsv? 1 1 1 I CI 


high 


1-4 1 o h nrrlpr hvtp 

I 11^11 U 1 t 1 U H L 


low 


Low order byte 


H 


Bits i through j 


.n 


on n 


AND 




NOT 


1 noiral rnmnlpmpnt 


rtR 

Un 


1 r\fjir*oi f~^R 
LUglLdl \Jf\ 


XOR 


I ooinal pvcln^ivp OR 


+ 


Plus 




Minus 


j 






Multiply 


(X) 


The contents of X 


((X)) 


The memory location addressed by (X) 




(The contents of X) 




Is equal to 


<> 


Is not equal to 


< 


Is less than 


> 


Is greater than 




Is replaced by 
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ACALL 

Absolute Call Within 2K Byte Page 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



Description: 



ACALL 
code address 
ACALL code address 



|aaa10001 | aaaaaaaa" 
7 7 

(PC) - (PC) + 2 

(SP)-(SP) + 1 

((SP)) - {PC low) 

(SP) -(SP) + 1 

{{SP)) ~ {PC high) 

(PC) 0-10 - page address 



C AC F0 RS1 rso ov 



PSW 

This instruction stores the incremented contents of the program 
counter (the return address) on the stack. The low-order byte of the 
program counter (PC) is always placed on the stack first. It replaces 
the low-order 11 bits of the PC with the encoded 11 -bit page 
address. The destination address specified in the source must be 
within the 2K byte page of the instruction following the ACALL. 

The 3 high-order bits of the 11-bit page address form the 3 high- 
order bits of the opcode. The remaining 8 bits of the address form 
the second byte of the instruction. 



Instruction Set 3-5 



Example: 



ORG 35H 

ACALL SORT ; Call SORT (evaluates to page 
; address 233H) 



ORG 233H 

SORT: PUSH ACC ; Store Accumulator 



RET 



; Return from call 



Encoded Instruction: 



01010001 



00110011 



7 7 

Before 

Program Counter 



After 

Program Counter 



| 00000000 | 00110101 | | ooooooi"o~ 



00110011 



15 8 7 

Stack Pointer 



15 

Stack Pointer 



00100110 



00101000 



7 

(27H) 



7 

(27H) 



00000000 



00110111 



7 

(28H) 



7 

(28H) 



00000000 
7 

Notes: 2, 3 



00000000 
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Add Immediate Data 



Mnemonic: ADD 



Operands: 

Format: 
Bit Pattern: 



A 
data 

ADD A,#data 



Accumulator 

-256 <= data <= + 255 



00 1 001 00 Immediate Data 



7 7 

Operation: (A) - (A) + data 



s: 2 
Cycles: 1 

Flags: 



Description: 



C AC F0 RS1 RS0 OV 



EE 



PSW 

This instruction adds the 8-bit immediate data value to the contents 
of the accumulator. It places the result in the accumulator. 



Example: ADD AJ32H 
Encoded Instruction: 



; Add 32H to accumulator 



| 00100100 | 00110010 



7 

Before 

Accumulator 
| 01 01 To~~| 
7 

Notes: 4,5,6,7 



After 

Accumulator 
| 01 01 1 00"] 
7 
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ADD 

Add Indirect Address 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 1 

Flags: 



ADD 

A 
Rr 



Accumulator 
Register <= r <= 1 



ADD A,@Rr 

| 010 0117] 
7 

(A) -(A) + ((Rr)) 



C AC F0 RS1 RSO OV 



PSW 

Description: This instruction adds the contents of the data memory location 
addressed by register r to the contents of the accumulator. It places 
the result in the accumulator. 



Example: ADD A,@R1 
Encoded Instruction: 



; Add indirect address to accumulator 



00100111 



7 
Before 
Accumulator 



After 

Accumulator 



10000110 



11101000 



7 
Register 1 



7 
Register 1 



00011100 



00011 100 



7 

(1CH) 



7 

(1CH) 



01100010 
7 

Notes: 5, 6, 7, 15 



01100010 
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ADD 

Add Register 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 1 

Flags: 



ADD 

A 
Rr 

ADD A.Rr 



Accumulator 
Register <=r<= 7 



| 00101 r77 



7 
(A) -(A) + (Rr) 

C AC F0 RS1 RSO OV 



I 'M I I h 



PSW 

Description: This instruction adds the contents of register r to the contents of 
the accumulator. It places the result in the accumulator. 



Example: ADD A.R6 
Encoded Instruction: 



: Add R6 to accumulator 



| 0101110" 



7 

Before 

Accumulator 
| 1 1 1 1 iT 



After 

Accumulator 



11111011 



Register 6 
| 1 00001 oT 
7 



7 
Register 6 



10000101 



Notes: 5, 6, 7 
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ADD 

Add Memory 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 

Description: 
Example: 



ADD 

A Accumulator 

data address <= data address <= 255 

ADD A,data address 



00100101 



Data Address 



7 7 

(A) — (A) + (data address) 

C AC F0 RS1 RS0 OV P 



PSW 

This instruction adds the contents of the specified data address to 
the contents of the accumulator. It places the result in the 
accumulator. 



ADD A.32H 



; Add the contents of 
; 32H to accumulator 



Encoded Instruction: 



| 00100101 | 00110010 



7 
Before 
Accumulator 



After 

Accumulator 



00100110 



01111001 



7 

(32H) 



01010011] 



7 
(32H) 

| 01 01 00lT 



7 
Notes: 5,6,7,8 
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ADDC 

Add Carry Plus Immediate Data to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



Bytes: 2 
Cycles: l 

Flags: 



Description: 



ADDC 
A 



Accumulator 

-256 <= data <= + 255 



ADDC A,#data 



00110100 



Immediate Data 



7 7 

(A) - (A) + (C) + data 



C AC F0 RS1 RS0 OV 



PSW 

This instruction adds the contents of the carry flag (0 or l) to the 
contents of the accumulator. The 8-bit immediate data value is 
added to that intermediate result, and the carry flag is updated. The 
accumulator and carry flag reflect the sum of all three values. 



ADDC A,#0AFH 
Encoded Instruction: 



; Add Carry and 0AFH to accumulator 



00110100 10101111 



Before 

Accumulator 
| 01 1 1 000 1~| 

7 

Carry 

m 

Notes: 4,5,6,7 



After 

Accumulator 



00100001 



Carry 

D3 



Assembler Directives 



This chapter describes the assembler directives. It shows how to define symbols and 
how to control the placement of code and data in program memory. 



Introduction 

The MCS-51 assembler has several directives that permit you to set symbol values, 
reserve and initialize storage space, and control the placement of your code. 

The directives should not be confused with instructions. They do not produce exe- 
cutable code, and with the exception of the DB and DW directives, they have no 
direct effect on the contents of code memory. What they do is change the state of the 
assembler, define user symbols, and add information (other than pure object code) 
to the object file (e.g., segment definitions). 

The directives are divided into the following categories: 

Symbol Definition 
SEGMENT 
EQU 
SET 
DATA 
IDATA 
XDATA 
BIT 
CODE 

Storage Initialization/ Reservation 
DS 
DB 
DW 
DBIT 

Program Linkage 
PUBLIC 
EXTRN 
NAME 

Assembler State Control 
ORG 
END 

Segment Selection Directives 

RSEG 

CSEG 

DSEG 

XSEG 

ISEG 

BSEG 

USING 

The MCS-51 assembler is a two-pass assembler. In the first pass, symbol values are 
determined, and in the second, forward references are resolved, and object code is 
produced. This structure imposes a restriction on the source program: expressions 
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which define symbol values (see Symbol Definition Directives) and expressions 
which control the location counter (see ORG, DS, and DBIT directives) may not 
have forward references. 



The Location Counter 

The location counter in ASM51 is a pointer to the address space of the active seg- 
ment. When a segment is first activated, the location counter is (unless a base 
address was specified using the segment select directives). The location counter is 
changed after each instruction by the length of the instruction. You can change its 
value with the ORG directive, which sets a new program origin for statements that 
follow it. The storage initialization and reservation directives (DS, DB, DW, and 
DBIT) change the value of the location counter as statements are encountered within 
a segment. If you change segments and later return to that segment, the location 
counter is restored to its previous value. Whenever the assembler encounters a label, 
it assigns to the label the current value of the location counter and the type of the 
current segment. 

The dollar sign ($) indicates the value of the active segment's location counter. 
When you use the location counter symbol, keep in mind that its value changes with 
each instruction, but only after that instruction has been completely evaluated. If 
you use $ in an operand to an instruction or a directive, it represents the code 
address of the first byte of that instruction. 

MSG: DB MSG_ LENGTH, 'THIS IS A MESSAGE' 
MSG LENGTH EQU $-MSG-1 ;message length 



Symbol Names 

A symbol name must begin with a letter or a special character (either ? or _), 
followed by letters, special characters, or digits. 

You can use up to 255 characters in a symbol name, but only the first 31 characters 
are significant. A symbol name may contain upper- or lower-case characters, but the 
assembler converts to upper-case characters for internal representation. So, to ASM51, 
"buffer" is the same as "BUFFER" and the name 

" A THIRTY _ONE_CHARACTER STRING " 

is the same as the name 

"_A _ THIRTY _ONE_ CHARACTER STRING PLUS THIS." 
although the strings are different. 

The instruction mnemonics, assembly-time operators, predefined bit and data 
addresses, segment attributes, and assembler directives may not be used as user- 
defined symbol names. For a complete list of these reserved words, refer to 
Appendix F. 



Statement Labels 

A label is a symbol. All of the rules for forming symbol names apply to labels. A 
statement label is the first field in a line, but it may be preceded by any number of 
tabs or spaces. You must place a colon (:) after a label to identify it as a label. Only 
one label is permitted per line. 
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Labels are allowed only before empty statements, machine instructions, data initial- 
ization directives (DB and DW), and storage reservation directives (DS and DB1T). 
Simple names (without colons) can only precede symbol definition directives (EQU, 
SET, CODE, DATA, 1DATA, XDATA, BIT, and SEGMENT). All other 
statements may not be preceded by labels or simple names. 

When a label is defined, it receives a numeric value and segment type. The numeric 
value will always be the current value of the location counter of the currently 
selected segment at the point of use. The value of the label will be relocatable or 
absolute depending on the relocatability of the current segment. The segment type 
will be equivalent to the segment type of the current segment. 

Several examples of lines containing labels are shown below: 

LABEL! : DS 1 

LABEL2: ;This line contains no instruction; it is an empty statement 

LAB3: DB 27, 33, 'FIVE' 

MOV _ PROC: MOV DPTR JLABEL3 

You can use labels like any other symbol, as a memory address, or a numeric value 
in an assembly-time expression. A label, once defined, may not be redefined. 



Symbol Definition 

The symbol definition directives allow you to create symbols that can be used to 
represent segments, registers, numbers, and addresses. None of these directives may 
be preceded by a label. 

Symbols defined by these directives may not have been previously defined and may 
not be redefined by any means. The SET directive is the only exception to this. 

SEGMENT Directive 

The format for the SEGMENT directive is shown below. Note that a label is not 
permitted. 

relocatable segment name SEGMENT segment type /relocation type/ 

The SEGMENT directive allows you to declare a relocatable segment, assign a set of 
attributes, and initialize the location counter to zero (0). 

Although the name of a relocatable segment must be unique in the module, you can 
define portions of the segment within other modules and let RL51 combine them. 
When you do this, the segment type attributes must all be the same and the reloca- 
tion types must either be the same or be of two types, one of which is UNIT (see 
below). In the latter case, the more restrictive type will override. 

The segment type specifies the address space where the segment will reside. The 
allowable segment types are: 

• CODE— the code space 

• XDATA — the external data space 

• DATA— the internal data space accessible by direct addressing (0 to 127) 

• IDATA— the entire internal data space accessible by indirect addressing (0 to 
127) 

• BIT— the bit space (overlapping locations 32 to 47 of the internal data space) 
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The relocation type, which is optional, defines the relocation possibilities to be assigned 
by the RL5 1 . The allowable relocation types are: 

• PAGE — specifies a segment whose start address must be on a 256-byte page 
boundary. Allowed only with CODE and XDATA segment types. 

• IN PAGE— specifies a segment which must be contained in a 256-byte page. 
Allowed only with CODE and XDATA segment types. 

• INBLOCK— specifies a segment which must be contained in a 2048-byte block. 
Allowed only for CODE segments. 

• BIT ADDRESS ABLE — specifies a segment which will be relocated by RL51 
within the bit space on a byte boundary. Allowed only for DATA segments; 
limited to a 16-byte maximum size. 

• UNIT— specifies a segment which will be aligned on a unit boundary. This will 
be a byte boundary for CODE, XDATA, DATA, and IDATA segments and a 
bit boundary for BIT segments. This relocation type is the default value. 

NOTE 

When used in expressions, the segment symbol stands for the base 
address of the combined segment. 

Any DATA or IDATA segments may be used as a stack (there is no explicit stack 
segment). 

For example, 

STACK SEGMENT IDATA 



EQU Directive 

The format for the EQU directive is shown below. Note that a label is not permitted. 
symbol_name EQU expression 



symbol name EQU special assembler symbol 

The EQU directive assigns a numeric value or special assembler symbol to a 
specified symbol name. The symbol name must be a valid ASM51 symbol as 
described above. 

If you assign an expression to the symbol, it must be an absolute or simple 
relocatable expression with no forward references. You can use the symbol as a data 
address, code address, bit address, or external data address depending on the seg- 
ment type of the expression, i.e., the symbol will have the segment type of the 
expression. If the expression evaluates into NUMBER, the symbol will be con- 
sidered as such and will be allowed to be used everywhere. 

The special assembler symbols A, RO, Rl, R2, R3, R4, R5, R6, and R7 can be 
represented by user symbols defined with the EQU directive. If you define a symbol 
to a register value, it will have a type "REG". It can only be used in the place of that 
register in instruction operands. 



RSEG 
DS 



STACK 
10H 



;Reserve 16 bytes for stack 



MOV 



SPJSTACK-1 initialize stack pointer 



or 
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A symbol defined by the EQU directive cannot be defined anywhere else. 
The following examples show several uses of EQU: 

ACCUM EQU A ; define ACCUM to stand for A 

; (the 8051 accumulator) 
N27 EQU 27 ; set N27 to equal 27 

HERE EQU $ ; set HERE to current location counter 

; value 

DADDR1 EQU DADDR0 + 1 ; Assuming DADDRO is a DATA address 
; DADDR1 will also be a DATA address 

SET Directive 

The format for the SET directive is shown below. 
symbol name SET expression 

or 

symbol_name SB! special assembler_ symbol 

The SET directive operates similiar to EQU. The difference is that the defined sym- 
bol can be redefined later, using another SET directive. 

NOTE 

You cannot set a symbol which was equated and you cannot equate a sym- 
bol which was set. 

The following examples show several uses of SET: 

COUNT SET initialize absolute counter 

COUNT SET COUNT + 1 increment absolute counter 
HALF SET WHOLE/2 :Give half of WHOLE to HALF 

;the remainder is discarded 
H20 SET 32 ;SetH20to32 

INDIRECT SET R1 :Set INDIRECT to R1 

BIT Directive 

The format for the BIT directive is shown below. 

symbol name BIT bit^address 

The BIT directive assigns a bit address to the specified symbol name. 

Bit address format is described in Chapter 2. The symbol gets the segment type BIT. 
A symbol defined as BIT may not be redefined elsewhere in the program. 

The following examples show several uses of BIT: 

RSEG DATA_SEG ;A relocatable bit addressable segment 
CONTROL: DS 1 



ALARM BIT CONTROL. ;Bit in a relocatable byte 

OPEN_DOOR BIT ALARM + 1 ;The next bit 
RESET BOARD BIT 060H :An absolute bit 
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DATA Directive 

The format for the DATA directive is shown below. 



symbol name DATA expression 



The DATA directive assigns an on-chip data address to the specified symbol name. 
The expression must be an absolute or simple relocatable expression. Absolute 
expressions greater than 127 must specify a defined hardware register (see Chapter 
l). The segment type of the expression must be either DATA or NUMBER. The 
symbol gets the segment type DATA. 

A symbol defined by the DATA directive may not be redefined elsewhere in the 



The following examples show several uses of DATA: 



CONIN DATA SBUF 

TABLE BASE DATA 70H 

TABLE END DATA 7FH 

REL _TABLE DATA REL START + 1 



define CONIN to address 
the serial port buffer 
define TABLE BASE to be 
at location 70H 
define TABLE END to be 
at top of RAM (7FH) 
Define REL TABLE to be a 
relocatable symbol (assuming 
REL START is) 



XDATA Directive 

The format for the XDATA directive is shown below. 
symbol name XDATA expression 



The XDATA directive assigns an off-chip data address to the specified symbol 
name. The expression must be an absolute or simple relocatable expression. If the 
expression does not evaluate to a number, its segment type must be XDATA. The 
symbol gets the segment type XDATA. A symbol defined by the XDATA directive 
may not be redefined elsewhere in the program. 



The following examples show several uses of XDATA: 

RSEG XSEG1 

ORG 100H 
DATE: DS 5 
TIME XDATA DATE + 5 
PLACE XDATA TIME + 3 

IDATA Directive 

The format for the IDATA directive is shown below. 
symbol name IDAT A expression 



;Define DATE to 100H off XSEG1 base 
;define TIME to be 5 bytes after DATE 
:define PLACE to be 3 bytes after TIME 



The IDATA directive assigns an indirect internal data address to the specified sym- 
bol name. The expression must be an absolute or simple relocatable expression. 
Absolute expressions may not be larger than 127 for the 8051. The segment type of 
the expression must be either IDATA or NUMBER. The symbol gets the segment 
type IDATA. A symbol defined by the IDATA directive may not be redefined 
elsewhere in the program. 
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The following examples show 

BUFFER IDATA 
BUFFEFLLEN EQU 
BUFFER_END IDATA 



several uses of IDATA: 

60 H 
20 H 

BUFFER + BUFFER_LEN-1 



CODE Directive 

The format for the CODE directive is shown below. 



symbol ^name CODE expression 



The CODE directive assigns a code address to the specified symbol name. The 
expression must be an absolute or simple relocatable expression. If the expression 
does not evaluate to a number, its segment type must be CODE. The symbol gets a 
segment type of CODE. A symbol defined by the CODE directive may not be 
redefined elsewhere in the program. 



The following examples show several uses of the CODE directive: 



RESTART 
INT VECO 
INT VEC1 
INT_VEC2 



CODE 00H 

CODE 03H 

CODE OBH 

CODE 1BH 



Storage Initialization and Reservation 

The storage initialization and reservation directives are used to initialize and reserve 
space in either word, byte, or bit units. The space reserved starts at the point indi- 
cated by the current value of the location counter in the currently active segment. 
These directives may be preceded by a label. 

DS Directive 

The format of the DS directive is as follows: 
[label:] DS expression 

The DS directive reserves space in byte units. It can be used in any segment except a 
BIT type segment. The expression must be a valid assembly-time expression with no 
forward references and no relocatable or external references. When a DS statement 
is encountered in a program, the location counter of the current segment is incre- 
mented by the value of the expression. The sum of the location counter and the 
specified expression should not exceed the limitations of the current address space, 
or those set by the current relocation type. 



DBIT Directive 

The format of the DBIT directive is as follows: 

[label:] DBIT expression 

The DBIT directive reserves a space in bit units. It can be used only in a BIT type 
segment. The expression must be a valid assembly-time expression with no forward 
references. When the DBIT statement is encountered in a program, the location 
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counter of the current (BIT) segment is incremented by the value of the expression. 
Note that in a BIT segment, the basic unit of the location counter is in bits rather 
than bytes. 



DB Directive 

The format for a DB directive is shown below: 

{label: \ DB expression llsl 

The DB directive initializes code memory with byte values. Therefore, a CODE type 
segment must be active. The expression list is a series of one or more byte values or 
strings separated by commas!,). A byte value can be represented as an absolute or 
simple relocatable expression or as a character string. Each item in the list (expres- 
sion or character string) is placed in memory in the same order as it appears in the 
list. 

The DB directive permits character strings longer than 2 characters, but they must 
not be part of an expression (i.e., you cannot use long character strings with an 
operator, including parentheses). If you specify the null character siring as an item 
in the list (not as part of an expression), it generates no data. If the directive has a 
label, the value of the label will be the address of the first byte in the list. 

The following examples show several ways you can specify the byte value list in a DB 
directive: 

AGE: DB ■MARY , ,0,27,'BILL\0,25,'JOE',0,21,SUE'.0.18 
; This DB statement lists the names (character strings) 
; and ages (numbers) that have been placed in a list (the label 
: AGE will address the "M" in "MARY") 

PRIMES: DB 1 ,2.3,5,7,1 1 ,13.17,19,23,29.31 ,37.41 ,43,47.53 
; This DB lists the first 17 prime numbers. 
: (PRIMES is the address of 1) 

QUOTE: DB THIS IS AQUOTE"' : This is an example ot how to put the 

: quote character in a character 
; string. 



DW Directive 

The format for a DW statement is shown below: 

[label: ] DW expression list 

The DW directive initializes code memory with a list of word (16-bit) values. 
Therefore, a CODE type segment must be active. The expression list can be a series 
of one or more word values separated by commas!,). Word values can be absolute or 
simple relocatable expressions. If you use the location counter ($) in the list, it 
evaluates to the code address of the word being initialized. Unlike the DB directive, 
no more than two characters are permitted in a character string, and the null 
character string evaluates to 0. 

Each item in the list is placed in memory in the same order as it appears in the list, 
with the high order byte first, followed by the low order byte (unlike the way it is 
handled by the ASM80/86). If the statement has a label, the value of the label will 
address the first value in the list (i.e., the high order byte of the first word). 
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The following examples show several ways you can specify the word value list in a 
DW directive: 

ARRIVALS: DW 710,'AM'. 943, AM , 315/PM\94VPM' 
: This DW lists several flight arrivals. 
; The numbers and characters are encoded 
: consecutively. 

INVENTORY: DW F', 27869, 'G', 34524, 'X', 27834 

; This list of characters and numeric 
; values will be encoded with the high 
; order byte of each character string 
: filled with zeros. INVENTORY will 
: address a zero byte. 

JUMP _TABLE DW GO PROC, BREAK PROC, DISPLAY PROC 

: A jump table is constructed by listing 

; the procedure addresses 
DW $. $-2, $-4, $-6 : This DW statement initializes four 

: words of memory with the same value. 

; (The location counter is incremented 

; by 2 for each item in the list.) 



Program Linkage 

Program linkage directives allow the separately assembled modules to communicate 
by permitting intermodule references and the naming of modules. 

PUBLIC Directive 

The format for the PUBLIC directive is shown below: 

PUBLIC list _ of_names 

The PUBLIC directive allows symbols to be known outside the currently assembled 
module. If more than one name is declared public, the names must be separated by 
commas (,). Each symbol name may be declared public only once in a module. Any 
symbol declared PUBLIC must have been defined somewhere else in the program. 
Predefined symbols and symbols defined as registers or segments (declared via the 
SEGMENT directive) may not be specified as PUBLIC. 

The following examples show several uses of the PUBLIC directive: 

PUBLIC put crlf, put_string, put_data_str 
PUBLIC ascbin. binasc 
PUBLIC liner 



EXTRN Directive 

The format for the EXTRN directive is shown below: 

EXTRN [segments type (list_of__symbol__ names)], ... 

The EXTRN directive lists symbols to be referenced in the current module that are 
defined in other modules. This directive may appear anywhere in the program. 
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The list of external symbols must have a segment type associated with each symbol 
on the list. (The segment types are CODE, XDATA, DATA, IDATA, BIT, and 
NUMBER, i.e., a typeless symbol.) The segment type indicates the way a symbol 
may be used (e.g., a CODE type external symbol may be used as a target to a jump 
instruction but not as the target of a move instruction). At link and locate time, the 
segment type of the corresponding public symbol must match the segment type of 
the EXTRN directive. This match is accomplished if either type is NUMBER or if 
both types are the same. 

The following examples show several uses of the EXTRN directive: 

EXTRN CODE (put crlf, put_string. get_num), DATA (count, total) 

EXTRN CODE (binasc, ascbin). NUMBER (table size) 



NAME Directive 

The format for the NAME directive is shown below: 
NAME module_name 

The NAME directive is used to identify the current program module. All the rules 
for naming apply to the module name. The NAME directive should be placed before 
all directives and machine instructions in the module. Only comments and control 
lines can precede the NAME directive. 

If you choose not to use the name directive, the root (i.e., the file name without both 
the drive and the extension identifiers) of the source filename is used as the default. 

NOTE 

When filename roots start with a digit and the NAME directive is not 
specified, the module name cannot be used in the RL51 module list (such a 
module name is illegal for RL51). 

The symbol used in the NAME directive is considered undefined for the rest of the 
program unless it is specifically defined later. 

The following examples show several uses of the NAME directive: 

NAME track 
NAME compass 
NAMEchapter_45 



Assembler State Controls 



END Directive 

Every program must have an END statement. Its format is shown below: 
END 

The END statement must not have a label, and only a comment may appear on the 
line with it. The END statement should be the last line in the program; otherwise, 
this will produce an error. 



Assembler Directives 4-11 



ORG Directive 

The ORG directive is used to alter the assembler's location counter to set a new pro- 
gram origin for statements that follow the directive. 

The format for the ORG directive is shown below. Note that a label is not permitted. 
ORG expression 

The expression should be an absolute or simple relocatable expression referencing 
the current segment and containing no forward references. 

When the ORG directive is encountered in a program, the value of the expression is 
computed as the new value of the location counter specifying the address at which 
the next machine instruction or data item will be assembled in the current selected 
segment. If the current segment is absolute, the value will be an absolute address in 
the current segment; if the segment is relocatable, the value will be offset from the 
base address of the instance of the segment in the current module. 

The ORG directive modifies the location counter; it does not generate a new seg- 
ment. That is, when the location counter is incremented from the current value, the 
space between the previous and the current location counter becomes part of the cur- 
rent segment. 

In an absolute segment, the location counter must not be decremented to an address 
below the beginning of that segment. 

Examples: 

ORG ($ + 1 0H (AND OFFFOH ; set location counter to next 

; 16-byte boundary 
ORG 50 ; set location counter to 50 



Segment Selection Directives 

The segment selection directives will divert the succeeding code or data into the 
selected segment until another segment is selected by a segment selection directive. 
The directives may select a previously defined relocatable segment, or optionally 
create and select absolute segments. 

The format for relocatable segment selection directives is shown below. Note that a 
label is not permitted and that the name must be previously defined as a segment 



RSEG segment name 

The format for absolute segment select directives is shown below. Note that a label is 
not permitted here either. 



CSEG 
XSEG 
DSEG 
ISEG 
BSEG 



I AT absolute address] 



CSEG, DSEG, ISEG, BSEG, and XSEG select an absolute segment within the code, 
internal data, indirect internal data, bit, or external data address spaces, respec- 
tively. If you choose to specify an absolute address (by including "AT absolute 
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address"), the assembler terminates the last absolute segment, if any, of the 
specified segment type, and creates a new absolute segment starting at that address . 
If you do not specify an absolute address, the last absolute segment of the specified 
type is continued. If no absolute segment of this type was selected and the absolute 
address is omitted, a new segment is created starting at location 0. You cannot use 
any forward references and the start address must be an absolute expression. 

Each segment has its own location counter; this location counter is always set to in 
the initial state. The default segment is an absolute code segment; therefore, the 
initial state of the assembler is location in the absolute code segment. When 
another segment is chosen for the first time, the location counter of the former seg- 
ment retains the last active value. When that former segment is reselected, the loca- 
tion counter picks up at the last active value. You can use the ORG directive to 
change the location counter within the currently selected segment. 



DATA_SEG1 


SEGMENT 


DATA 


; A relocatable data segment 


CODE SEG1 


SEGMENT 


CODE 


; A relocatable code segment 




BSEG AT70H 


; Absolute bit segment 


DECIMAL MODE 


DBIT 


1 


: Absolute bit 


CHAR MODE: 


DBIT 


1 






RSEG 


DATA 


SEG1 ; Select the relocatable data segment 


TOTAL1 : 


DS 


1 




COUNT1: 


DS 


1 




COUNT W: 


DS 


2 






RSEG 


CODE 


SEG1 ; Select the relocatable code segment 


BEGIN CODE; 









USING Directive 

The formal for the USING directive is shown below. Note that a label is not 
permitted. 

USING expression 

This directive notifies the assembler of the register bank that is used by the subse- 
quent code. The expression is the number (between and 3 inclusive) which refers to 
one of four register banks. 

The USING directive allows you to use the predefined symbolic register addresses 
(ARO through AR7) instead of their absolute addresses. In addition, the directive 
causes the assembler to reserve a space for the specified register bank. 

Examples: 

USING 3 

PUSH AR2 ;Push register 2 of bank 3 

USING 1 

PUSH AR2 ;Push register 2 of bank 1 

Note that if you equate a symbol (e.g., using EQU directive) to an ARi symbol, the 
user-defined symbol will not change its value as a result of the subsequent USING 
directive. 



Instruction Set 3-11 



ADDC 

Add Carry Plus Indirect Address to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 1 



Description: 



ADDC 

A Accumulator 

Rr Register < = r < = 1 

ADDC A,@Rr 



001 1 01 1 r 



7 
(A) -(A) + (C) + ((Rr)) 

C AC F0 RS1 RSO OV 



PSW 

This instruction adds the contents of the carry flag (0 or 1) to the 
contents of the accumulator. The contents of data memory at the 
location addressed by register r is added to that intermediate result, 
and the carry flag is updated. The accumulator and carry flag 
reflect the sum of all three values. 
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ADDC 

Example: ADDC A, 

Encoded Instruction: 

| 001 1 01 lT~| 
7 

Before 

Accumulator 
| 1 1 1 1 0~| 
7 

Register 1 
| 011010 oT~| 
7 

(69H) 

| 01 1 o"o~| 

7 
Carry 



; Add carry and indirect address to 
; accumulator 



After 

Accumulator 



00000000 



7 
Register 1 



| 011010 oT" 
7 

(69 H) 

| 00011000" 

7 
Carry 



1 



Notes: 5,6,7, 15 



Instruction Set 3- 1 3 



ADDC 

Add Carry Plus Register to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



ADDC 

A 
Rr 



Accumulator 
Register < = r < = 



ADDC A,Rr 

| 00111 rrr \ 
7 

Operation: (A) - (A) + (C) + (Rr) 

Bytes: 1 
Cycles: 1 



Flags: 



Description: 



Example: 



C AC F0 RS1 RSO OV 



l * l I I I * I I 



PSW 

This instruction adds the contents of the carry flag (0 or 1) to the 
contents of the accumulator at bit 0. The contents of register r is 
added to that intermediate result, and the carry flag is updated. The 
accumulator and carry flag reflect the sum of all three values. 



ADDC A,R7 



; Add carry and register 7 
; to accumulator 



Encoded Instruction: 



| 00111111 
7 

Before 

Accumulator 



After 

Accumulator 



00110000 



00111011 



7 
Register 7 



7 
Register 7 



00001010 



00001010 



Carry 

m 

Notes: 5,6,7 



7 

Carry 
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Add Carry Plus Memory to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



ADDC 

A Accumulator 

data address <= data address <= 255 

ADDC A,data address 



| 00110101 | Data Address | 
7 7 

Operation: (A) — (A) + (C) + (data address) 

Bytes: 2 
Cycles: 1 



C AC F0 RS1 RS0 OV 
*l*l 



Description: 



Example: 



PSW 

This instruction adds the contents of the carry flag (0 or 1) to the 
contents of the accumulator. The contents of the specified data 
address is added to that intermediate result, and the carry flag is 
updated. The accumulator and carry flag reflect the sum of all 
three values. 



ADDC A.25H 



; Add carry and contents of 25H to 
; accumulator 



Encoded Instruction: 



00110101 



00100101 







Accumulator 
| 1 1 1 1 l~b~ 



After 

Accumulator 



10110101 



7 

(25H) 



7 

(25H) 



| 0000011 f 



00000111 



7 

Carry 

m 



7 

Carry 



Notes: 5,6,7,8 



Instruction Set 3-15 



AJMP 

Absolute Jump within 2K Byte Page 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



Description: 



AJMP 

code address 
AJMP code address 



| a a a 1 aaaaaaaa 



7 7 

(PC) -(PC) + 2 

(PC) 0-1 *- page address 



C AC F0 RS1 RSO OV 



Example: 



PSW 

This instruction replaces the low-order 1 1 bits of the program 
counter with the encoded 11-bit address. The destination address 
specified in the source must be within the 2K byte page of the 
instruction following the AJMP. 

The 3 high-order bits of the 11 -bit page address form the 3 high- 
order bits of the opcode. The remaining 8 bits of the address form 
the second byte of the instruction. 

ORG 0E80FH 
TOPP: MOVA,R1 



ORG OEADCH 

AJMP TOPP ; Jump backwards to TOPP 
; at location 0E80FH 



Encoded Instruction: 



00000001 



00001111 



7 7 

Before 

Program Counter 
| 1 1 1 01 0lF 
15 8 

Notes: None 



After 

Program Counter 



11011100 



11101000 



00001111 



15 



8 



3-16 MCS®-51 Macro Assembler 



ANL 

Logical AND Immediate Data to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: l 



Description: 



ANL 
A 

data 



Accumulator 

-255 <= data <= +255 



ANL A,#dafa 



01010100 



Immediate Data 



7 7 

(A) -(A) AND data 

C AC F0 RS1 RS0 OV 



PSW 

This instruction ANDs the 8-bit immediate data value to the 
contents of the accumulator. Bit n of the result is 1 if bit n of each 
operand is 1; otherwise bit n is 0. It places the result in the 
accumulator. 



Example: ANL AJ00001000B ; Mask out all but bit 3 
Encoded Instruction: 



01010100 | 0000 1 00 0" 



Before 
Accumulator 



| o 1 1 1 o 1 iT 

7 



After 

Accumulator 



00000000 



Notes: 4,5 



Instruction Set 3-17 



ANL 

Logical AND Indirect Address to Accumulator 



Mnemonic: ANL 



Operands: 

Format: 
Bit Pattern: 



A 
Rr 

ANL A,@Rr 

| 010101 f7~| 
7 



Accumulator 
Register <=r<=1 



Operation: (A) — (A) AND ((Rr)) 

Bytes: 1 
Cycles: 1 



Flags: 



Description: 



C AC F0 RS1 RSO OV 



PSW 

This instruction ANDs the contents of the memory location 
addressed by the contents of register r to the contents of the 
accumulator. Bit n of the result is 1 if bit n of each operand is 1; 
otherwise bit n is 0. It places the result in the accumulator. 



Example: ANL A, 



Encoded Instruction: 



; AND indirect address with 
; accumulator 



| 01010110" 
7 

Before 

Accumulator 
| 001 1 1 1 1~ 
7 

Register 



After 

Accumulator 



| 1 1 1T 

7 

Register 



01010010 



01010010 



7 

(52H) 



| 00001111 
7 

Notes: 5, 15 



7 

(52H) 

| 00001111 
7 
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ANL 

Logical AND Register to Accumulator 



Mnemonic: ANL 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: I 
Cycles: 1 

Flags: 

Description: 
Example: 



A 

Rr 

ANL A,Rr 



Accumulator 

0<= Rr <=7 



01 01 1 rrr 



7 
(A) — (A) AND (Rr) 

C AC F0 RS1 RSO OV 



PSW 

This instruction ANDs the contents of register r to the contents of 
the accumulator. Bit n of the result is 1 if bit n of each operand is 1 ; 
otherwise bit n is 0. It places the result in the accumulator. 

MOV R4,#10000000B ; Move mask to R4 

ANL A,R4 ; AND register 4 with accumulator 



Encoded Instruction: 

| 01011100 I 
7 

Before 

Accumulator 



After 

Accumulator 



10011001 



10000000 



7 

Register 4 
| 1 oT 
7 

Note: 5 



7 
Register 4 



10000000 



Instruction Set 3-19 



ANL 

Logical AND Memory to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 

Description: 
Example: 



ANL 

A Accumulator 

data address <= data address <= 255 

ANL A, data address 



01010101 



Data Address 



7 7 

(A) - (A) AND (data address) 

C AC F0 RS1 RS0 OV P 



PSW 

This instruction ANDs the contents of the specified data address to 
the contents of the accumulator. Bit n of the result is l if bit n of 
each operand is also l ; otherwise bit n is 0. It places the result in the 
accumulator. 



ANL A.37H 



; AND contents of 37H with 
; accumulator 



Encoded Instruction: 



| 01010101 | 001 1 0lTT 



7 

Before 

Accumulator 
| 0111011 1 | 
7 

(37H) 



After 

Accumulator 



01110000 



7 

(37H) 



11110000 
7 

Notes: 5,8 



11110000 
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ANL 

Logical AND Bit to Carry Flag 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: l 

Flags: 

Description: 
Example: 



ANL 

C 

bit address 



Cany Flag 

<= bit address <= 255 



ANL C,bit address 



1 0000 01 Bit Address 



7 7 

(C) — (C) AND (bit address) 



c AC F0 RS1 rso ov 

•n 



PSW 

This instruction ANDs the contents of the specified bit address to 
the contents of the carry flag. I f both bits are 1 , then the result is 1 ; 
otherwise, the result is 0. It places the result in the carry flag. 



ANL C.37.3 



; AND bit 3 of byte 37 with Carry 



Encoded Instruction: 



| 10000010 | 00101 o~TT 



7 

Before 
Carry Flag 

m 

(37) 



00101110 



7 3 
Notes: None 



After 

Carry Flag 

m 

(37) 

| 001011 10~~| 
7 3 



Instruction Set 3-21 



ANL 

Logical AND Complement of Bit to Carry Flag 



Operands: 



Format: 
Bit Pattern: 



ANL 

C 

bit address 



Carry Flag 

<= bit address <= 255 



ANL C, / bit address 



10110000 



Bit Address 



Operation: (C) - (C) AND NOT {bit address) 

Bytes: 2 

2 



Flags: 



Description: 



Example: 



C AC FO RS1 RSO OV 



PSW 

This instruction ANDs the complemented contents of the specified 
bit address to the contents of the carry flag. The result is 1 when the 
carry flag is 1 and the contents of the specified bit address is 0. It 
places the result in the carry flag. The contents of the specified bit 
address does not change. 



ANL C, , '40.5 



; Complement contents of 40.5 
; then AND with Carry 



Encoded Instruction: 



10110000 | 010001 0~1~| 



7 

Before 
Carry Flag 



3 



After 

Carry Flag 

m 



(40) 



(40) 



01011000 
7 5 



01011000 
7 5 



Notes: None 
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Logical AND Immediate Data to Memory 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 3 
Cycles: 2 

Flags: 

Description: 
Example: 



ANL 

data address <=data address <= 255 
data -256 <= data <= + 255 

ANL data address ,1tdata 



01010 011 | Data Address |lmmediate Data 



7 7 7 

{data address) — {data address) AND data 

C AC FO RS1 RS0 OV P 



PSW 

This instruction ANDs the 8-bit immediate data value to the 
contents of the specified data address. Bit n of the result is 1 if bit n 
of each operand is also 1 ; otherwise, bit n is 0. It places the result in 
data memory at the specified address. 



MOV 57H.PSW 
ANL 57HJ01H 



Move PSW to 57H 

Mask out all but parity bit 

to check accumulator parity 



Encoded Instruction: 



01010011 01010111 00000001 



7 

Before 
(57H) 



7 
After 
(57H) 



01110111 
7 

Notes: 4,9 



00000001 



Instruction Set 3-23 



Logical AND Accumulator to Memory 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



ANL 

data address <= data address <= 255 
A Accumulator 

ANL data address, A 



| 01010010" 



Data Address 



7 7 

Operation: (data address) *~ {data address) AND A 



Flags: 



Description: 



C AC F0 RS1 RS0 OV 



PSW 

This instruction ANDs the contents of the accumulator to the 
contents of the specified data address. Bit n of the result is 1 if bit n 
of each operand is also 1; otherwise, bit n is 0. It places the result 
in data memory at the specified address. 



Example: 

Encoded Instruction 



MOV A, #100000018 
ANL 10H.A 



; Load mask into accumulator 
; Mask out all but bits and 7 



01010010 



00010000 



7 
Before 
Accumulator 



After 

Accumulator 



1 0000001 



10000001 



7 

(10H) 



7 

(10H) 



00110001 



00000001 
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CALL 

Generic Call 



Mnemonic: CALL 

Operands: code address 

Format: CALL code address 

Bit Pattern: Translated to ACALL or LCALL as needed 

Operation: Either ACALL or LCALL 

Flags: c AC fo rsi rso ov p 



PSW 

Description: This instruction is translated to ACALL when the specified code 
address contains no forward references and that address falls 
within the current 2K byte page; otherwise; it is translated to 
LCALL. This will not necessarily be the most efficient representa- 
tion when a forward reference is used. See the description for 
ACALL and LCALL for more detail. 

Example: ORG 80DCH 

Call SUB3 (SUB3 is a forward 
reference so LCALL is encoded 
even though ACALL would work in 
this case.) 
Address 8233H 



CALL SUB3 



SUB3: 
Encoded Instruction: 



POP 55H 



00010010 



10000010 



00110011 



7 7 

Before 

Program Counter 



7 
After 

Program Counter 



10000000 



11011100 



10000010 



00110011 



15 



Stack Pointer 
| 01 1 01 00" 
7 

(65H) 



00000000 



7 
(66H) 

| oooooooo" 

7 



Stack Pointer 



01100110 



7 

(65H) 



11011111 



7 

(66H) 



10000000 



Notes: 1,2,3 



Instruction Set 3-25 



Compare Indirect Address to Immediate Data, 
Jump if Not Equal 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



CJNE 

Hr Register 0<=/-<=1 

data -256 <= data <= +255 

code address 

CJNE @Rr ,#dafa , code address 



1 01 1 01 1 r 



Immediate Data 



Rel. Offset 



7 



7 



Operation: (PC) -(PC) + 3 
IF ((Hr)) <> data 
THEN 

(PC) *- (PC) + relative offset 
IF ((Rr)) < data 
THEN 

(C)-1 

ELSE 

(C)-0 



Bytes: 3 
Cycles: 2 

Flags: 



C AC F0 RS1 RSO OV 



PSW 



Description: This instruction compares the immediate data value with the 
memory location addressed by register r. If they are not equal, con- 
trol passes to the specified code address. If they are equal, then 
control passes to the next sequential instruction. 

If the immediate data value is greater than the contents of the 
specified data address, then the carry flag is set to 1; otherwise, it is 
reset toO. 



The Program Counter is incremented to the next instruction. If the 
operands are not equal, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 
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CJNE 

Example: 



CJNE @R1J01,SCAB; Jump if contents of 
; indirect address do 
; not equal 1 



SCAB: MOVC.FO 



; 5AH bytes from the 
beginning of CJNE 



Encoded Instruction: 



| 10110111 | 00000001 | 01010111 



7 

Before 



Register 1 
| 1 1 iT 



7 
After 
Register 1 



(53H) 

| 1 1 1 oT 



Carry Flag 

m 

Program Counter 



00000000 



11011100 



15 8 7 

Notes: 4, 10, 11, 12, 15 



| 1 1 1~ 



7 

(53H) 



1110000' 



7 
Carry Flag 



Program Counter 

00000001 | polio iTb~ 



15 



Instruction Set 3-27 



CJNE 

Compare Immediate Data to Accumulator, 
Jump if Not Equal 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



CJNE 

A Accumulator 

data -256 <= data <= + 255 

code address 

CJNE h^data, code address 



| 10110100 |lmmediate Data | Rel. Offset 
7 7 7 

(PC) -(PC) + 3 
IF (A) < > date 
THEN 

(PC) - (PC) + relative offset 

IF (A) < data 
THEN 

(C)-1 

ELSE 

<C)-0 



C AC F0 RS1 RS0 OV 



r*TTT 



n 



PSW 

This instruction compares the immediate data value with the 
contents of the accumulator. If they are not equal, control passes to 
the specified code address. If they are equal, then control passes to 
the next sequential instruction. 

If the immediate data value is greater than the contents of the 
accumulator, then the carry flag is set to 1; otherwise, it is reset 
toO. 

The Program Counter is incremented to the next instruction. If the 
operands are not equal, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 
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ORG 10DCH 

CJNE A,#10H,NEXT ; Jump if accumulator does not equal 
;10H 



NEXT: 

Encoded Instruction: 



INC A 



; Location 11 36H 



10110100 



00010000 



01010111~| 



7 

Before 

Accumulator 
| 01 01 0000~] 
7 

Carry Flag 

m 



7 
After 

Accumulator 



Program Counter 



00010000 



011100 



15 8 7 

Notes: 4, 10, 11, 12 



01010000 



7 
Carry Flag 



Program Counter 



00010001 



00110110 



15 



8 



Instruction Set 3-29 



CJNE 

Compare Memory to Accumulator, 
Jump if Not Equal 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



CJNE 

A Accumulator 

data address <= data address <= 255 

code address 

CJNE A,data address, code address 



| 10110101 | Data Address | Rel. Offset 
7 7 7 

(PC) - (PC) + 3 

IF (A) <> (data address) 

THEN 

(PC) - (PC) + relative offset 
IF (A) < (data address) 
THEN 

(C)-1 

ELSE 

<C)~0 



C AC F0 RS1 RS0 OV 



PSW 

This instruction compares the contents of the specified memory 
location to the contents of the accumulator. If they are not equal, 
control passes to the specified code address. If they are equal, then 
control passes to the next sequential instruction. 

If the contents of the specified memory location is greater than the 
contents of the accumulator, then the carry flag is set to I; other- 
wise, it is reset to 0. 

The Program Counter is incremented to the next instruction. If the 
operands are not equal, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 
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CJNE 



Example: CJNE A.37H, TEST; Jump if 37H and accumulator 

; are not equal 



TEST: INC A 
Encoded Instruction: 



;4FH bytes from CJNE 



| 1 01 1 01 01 | 0011 0111 | 01 0011 00 



(37H) 

| 01111110~| 
7 

Accumulator 



7 
After 
(37H) 



01111110 



7 
Accumulator 



00100110 



00100110 



Carry Flag 

T 



Program Counter 

oooooooo | 11011 foci" 



7 
Carry Flag 

CD 

Program Counter 



00000001 



00110110 



15 8 7 

Notes: 8, 10, II, 12 



15 



8 



Instruction Set 3-31 



CJNE 

Compare Immediate Data to Register, 
Jump if Not Equal 



Mnemonic: CJNE 



Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Hr Register 0<=r<=7 

data -256 <= data <= + 255 

code address 

CJNE Rrjdata, code address 



| 10111 



r r r 



Immediate Data Rel. Offset 



7 



7 



(PC) - (PC) + 3 

\?(W)Odata 

THEN 

(PC) - (PC) + relative offset 
\F(Rr)<data 
THEN 

(C)-1 

ELSE 

(C)-0 



C AC F0 RS1 RSO OV 



PSW 



Description: This instruction compares the immediate data value with the 
contents of register r. If they are not equal, control passes to the 
specified code address. If they are equal, then control passes to the 
next sequential instruction. 



If the immediate data value is greater than the contents of the 
specified register, then the carry flag is set to I ; otherwise, it is reset 
toO. 



The Program Counter is incremented to the next instruction. If the 
operands are not equal, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



32 MCS®-51 Macro Assembler 



CJNE 

Example: 



CJNE R5,#32H,SKIP10 ; Jump if register 5 does not 
; equal 32H 



SKIP10:MOV R5.P0 
Encoded Instruction: 

| 10111101 | 10000000 | 0000101Q 
7 7 7 

Before 

Register 5 



13 bytes from CJNE 



| 00000001 | 
7 

Carry Flag 

m 

Program Counter 



After 

Register 5 

| oooooooT 

7 
Carry Flag 



Program Counter 



00000000 



11011100 



00000000 



11101001 



15 8 7 

Notes: 4, 10, II, 12 



15 



8 7 



Instruction Set 3-33 



CLR 

Clear Accumulator 



Format: 
Bit Pattern: 



CLR 
A 

CLR A 



Accumulator 



11100100 



Operation: (A)-0 

Bytes: 1 
Cycles: 1 



Flags: 



C AC F0 RS1 RSO OV 



PSW 



Description: This instruction resets the accumulator to 0. 



Example: CLR A 

Encoded Instruction: 



[ 1110 01 0~0~ 



7 
Before 
Accumulator 



| 00111111" 



; Set accumulator toO 



After 

Accumulator 



00000000 
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Clear Carry Flag 



Mnemonic: 
Operands: 



Bit Pattern: 



CLR 

C 

CLR C 



Carry Flag 



11000011 



Operation: 

Bytes: 1 
Cycles: 1 

Flags: 



C AC F0 RS1 RSO OV 



PSW 

Description: This instruction resets the carry flag to 0. 



Example: CLR C 

Encoded Instruction: 

| 1 1 lT~| 

7 

Before 
Carry Flag 

m 

Notes: None 



; Set carry flag to 



After 

Carry Flag 



CLR 

Clear Bit 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



CLR 

bit address <= bit address <= 255 
CLR bit address 



1 00001 | Bit Addres"s~| 



7 7 

(bit address) —0 

C AC F0 RS1 RS0 OV 



PSW 

Description: This instruction resets the specified bit address to 0. 
Example: CLR 40.5 ; Set bit 5 of byte 40 to 

Encoded Instruction: 



| 11000010 | 01000101 



(40) 



00100110 
7 5 

Notes: None 



After 
(40) 



00000110 
7 5 
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Complement Accumulator 



Mnemonic: CPL 

Operands: A 

Format: CPL A 
Bit Pattern 



Accumulator 



| 11110100" 



7 

Operation: (A) -NOT (A) 

Bytes: 1 
Cycles: 1 



Flags: 



C AC FO RS1 RSO OV 



PSW 



Description: This instruction resets each 1 in the accumulator to 0, and sets each 
in the accumulator to I . 



CPL A 
Encoded Instruction: 



; Complement accumulator 



11110011 



7 
Before 
Accumulator 



After 

Accumulator 



00110101 



11001010 



7 
Notes: None 



Instruction Set 3-37 



Complement Carry Flag 



Mnemonic: CPL 



Operands: 
Format: 
Bit Pattern: 



C 

CPL C 



Carry flag 



| 10110 1~T~| 
7 



Operation: (C)-NOT(C) 

Bytes: 1 
Cycles: 1 



Flags: 



C AC FO RS1 RSO OV 



PSW 



Description: This instruction sets the carry flag to 1 if it was 0, and resets the 
carry flag to if it was 1 . 



Example: CPL C 

Encoded Instruction: 



; Complement Carry flag 



10110011 



7 
Before 
Carry Flag 

m 

Notes: None 



After 

Carry Flag 



3-38 MCS-51 Macro Assembler 



CPL 

Complement Bit 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: l 

Flags: 



CPL 

bit address <= bit address <= 255 
CPL bit address 



| 10110010 | Bit Address" 



7 7 

(bit address) - NOT (bit address) 

C AC F0 RS1 RS0 OV P 



PSW 

Description: This instruction sets the contents of the specified bit address to 1 if 
it was 0, and resets the contents of the bit address to if it was 1 . 



Example: CPL 33.7 
Encoded Instruction: 



; Set bit 7 of byte 33 toO 



10110010 



00001111 



7 

Before 



(33) 

| 1010 0110" 



7 
Notes: None 



After 

(33) 

I 01 01 l~b~| 



Instruction Set 3-39 



DA 

Decimal Adjust Accumulator 



Mnemonic: DA 



Operands: 
Format: 
Bit Pattern: 



A 

DA A 



Accumulator 



| 11010100" 



Operation: (See description below.) 

Bytes: 1 
Cycles: 1 



Flags: 



Description: 



C AC FO RS1 RSO OV 



PSW 

This instruction adjusts the contents of the accumulator to 
correspond to packed binary coded decimal (BCD) representation, 
after an add of two BCD numbers. If the auxiliary carry flag is 1, 
or the contents of the low order nibble (bits — 3) of the 
accumulator is greater than 9, then 6 is added to the accumulator. 
If the carry flag is set before or after the add or the contents of the 
high order nibble (bits 4—7) is greater than 9, then 60H is added to 
the accumulator. The accumulator and the carry flag contain the 
final adjusted value. 



ADD A,R1 
DA A 



Example: 

Encoded Instruction 

[ 110101 o"b~| 
7 

Before 

Accumulator 
| 10 0110 ri"~| 
7 

Carry Flag 

m 

Auxiliary Carry Flag 



; Adjust the Accumulator after add 



After 

Accumulator 



00000001 



Carry Flag 

m 

Auxiliary Carry Flag 

m 



Notes: 5,6 
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DEC 

Decrement Indirect Address 



Mnemonic: DEC 

Operands: Rr Register 0<=r<=1 

Format: DEC @Rr 
Bit Pattern: 



0001 01 1 r 



7 

Operation: ((R/-)) - ((R/-)) -1 

Bytes: 1 
Cycles: 1 



Flags: 



C AC FO RS1 RS0 OV 



PSW 



Description: This instruction decrements the contents of the memory location 
addressed by register r by 1. It places the result in the addressed 
location. 



Example: DEC@R0 
Encoded Instruction: 



; Decrement counter 



00010110 



7 
Before 
Register 



After 
RegisterO 



00110111 



00110111 



7 

(37H) 



7 

(37H) 



11011101 
7 

Note: 15 



11011100 





DEC 

Decrement Accumulator 



Instruction Set 3—4 1 



Mnemonic: DEC 

Operands: A 

Format: DEC A 
Bit Pattern: 



Flags: 



Description: 



Accumulator 



00010100 



7 

Operation: (A) — (A)-1 

Bytes: 1 
Cycles: 1 



C AC F0 RS1 RSO OV 



PSW 

This instruction decrements the contents of the accumulator by 1. 
It places the result in the accumulator. 



Example: DEC A 

Encoded Instruction: 



Decrement accumulator 



00010100 



Accumulator 



| 1 1 01 000 
7 
Note: 5 



After 

Accumulator 



11001111 
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DEC 

Decrement Register 



Mnemonic: DEC 

Operands: Hr 

Format: DEC Rr 
Bit Pattern 



Flags: 



Description: 



Register <=/■<= 7 



| 0001 1 rrr\ 
7 



Operation: (Rr)-(Rr)-1 

Bytes: 1 
Cycles: 1 



C AC FO RS1 RSO OV 



PSW 

This instruction decrements the contents of register r by 1 . It places 
the result in the specified register. 



Example: DEC R7 

Encoded Instruction: 



; Decrement register 7 



0001 1 1 1 1~| 



7 

Before 

Register 7 
| 10101011 
7 

Notes: None 



After 

Register 7 



1 1 1 1 0~| 



Instruction Set 3-43 



Decrement Memory 



Mnemonic: DEC 

Operands: data address <= data address <= 255 
DEC data address 



Bit Pattern: 



Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



on: 



00010101 



Data Address 



7 7 

{data address) — (data address) -1 

C AC F0 RS1 RS0 OV P 



PSW 

This instruction decrements the contents of the specified data 
address by 1 . It places the result in the addressed location. 



Example: DEC 37H 

Encoded Instruction: 



Decrement counter 



00010101 



00110111 



7 

Before 
(37H) 



After 
(37H) 



| 110111 l"b~| 
7 



11011101 



Note: 9 
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DIV 

Divide Accumulator by B 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 4 

Flags: 

Description: 



DIV 
AB 

DIV AB 



Register Pair 



10000100 



7 
(AB)-(A)/(B) 

C AC F0 RS1 RS0 OV 



PSW 

This instruction divides the contents of the accumulator by the 
contents of the multiplication register (B). Both operands are 
treated as unsigned integers. The accumulator contains the quo- 
tient; the multiplication register contains the remainder. 

The carry flag is always cleared. Division by sets the overflow 
flag; otherwise, it is cleared. 



Example: 

Encoded Instruction: 



MOV B,#5 
DIV AB 



; Divide accumulator by 5 



10000100 



Accumulator 



01110110 



7 
Multiplication Register (B) 



00000101 



After 

Accumulator 
0001 1 



7 
Multiplication Register (B) 



00000011 



Note: 5 



Instruction Set 3-45 



DJNZ 

Decrement Register and Jump if Not Zero 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



Description: 



DJNZ 

Rr Register <=/-<= 7 

code address 

DJNZ Rr, code address 



1 1 01 1 rrr 



Rel. Offset 



7 7 

(PC) -(PC) + 2 

(Rr)-(R/-) -1 

IF(Rf)<>0 

THEN 

(PC) - (PC) + re/af/Ve o/feef 



C AC FO RS1 RSO OV 



PSW 

This instruction decrements the contents of register r by 1, and 
places the result in the specified register. If the result of the decre- 
ment is 0, then control passes to the next sequential instruction; 
otherwise, control passes to the specified code address. 

The Program Counter is incremented to the next instruction. If the 
decrement does not result in 0, then the relative offset is added to 
the incremented program counter, and the instruction at that 
address is executed. 



Example: 



LOOP1: ADD A,R7 



; ADD index to accumulator 



DJNZ R7.LOOP1 
INC A 



Encoded Instruction: 



11011111 



11110001 



7 

Before 
Register 7 



00000010 



7 
Program Counter 
| 00000100 | 11011100 



15 8 7 

Notes: 10, 11, 12 



After 

Register 7 



; Decrement register 7 and 
; jump to LOOP1 (15 bytes 
; backward from INC 
; instruction) 



00000001 



7 
Program Counter 
000001 00 | 11001111 | 



15 



8 
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DJNZ 

Decrement Memory and Jump if Not Zero 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



DJNZ 

data address <= data address <= 255 
code address 

DJNZ data address .code address 



11010101 Data Address Rel. Offset 



7 



7 



(PC) -(PC) + 3 

{data address) — {data address) -1 

IF {data address) <> 

THEN 

(PC) - (PC) + relative offset 



C AC F0 RS1 RSO OV 



PSW 

This instruction decrements the contents of the specified data 
address by 1, and places the result in the addressed location. If the 
result of the decrement is 0, then control passes to the next sequen- 
tial instruction; otherwise, control passes to the specified code 
address. 

The Program Counter is incremented to the next instruction. If the 
decrement does not result in 0, then the relative offset is added to 
the incremented program counter, and the instruction at that 
address is executed. 



Instruction Set 3-47 



DJNZ 

Example: LOOP 3: MOV R7.57H ; Store loop index in register 7 



DJNZ57H,LOOP3 ; Decrement 57H and jump 
INC A ; backward to LOOP3 (51 bytes 

; backwards from the INC A 

; instruction) 



Instruction: 



I 11 01 01 oT 



01010111 



11001010 



7 

Before 
(57H) 



7 



7 
After 
(57H) 



01110111 



01110110 



Program Counter 
| 0000000~0 
15 8 7 

Notes: 9, 10, 11, 12 



7 
Program Counter 



11011100 



00000000 



10101001 



15 



8 7 
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INC 

Increment Indirect Address 



Mnemonic: INC 

Operands: Br 

Format: INC® Fir 
Bit Pattern: 



Register 0<=r<=1 



000001 1 r 



7 

Operation: ({Br)) - ((Br)) + 1 

Bytes: 1 
Cycles: I 



Flags: 



C AC F0 RS1 RS0 OV 



PSW 



Description: This instruction increments the contents of the memory location 
addressed by register r by 1. It places the result in the addressed 
location. 



Example: INC@R0 
Encoded Instruction: 

| 00000 1 1~0 | 
7 

Before 

Register 
1 00110010 | 
7 

(32H) 



; Increment counter 



After 

Register 



00110010 



7 

(32H) 



11011101 
7 

Note: 15 



11011110 



Instruction Set 3-49 



INC 

Increment Accumulator 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: I 

Flags: 



INC 
A 

INC A 



Accumulator 



00000100 



7 
(A) -(A) + 1 

C AC F0 RS1 RS0 OV 



PSW 

Description: This instruction increments the contents of the accumulator by l . li 
places the result in the accumulator. 



Example: INC A 

Encoded Instruction: 



Increment accumulator 



00000100 



Accumulator 
| 1 1 01 0000~ 
7 

Note: 5 



After 

Accumulator 
| 1101000T 
7 
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INC 

Increment Data Pointer 



Mnemonic: INC 

DPTR 



Data Pointer 



Bit Pattern: 



INC DPTR 

| 10100011 
7 



Operation: (DPTR) - (DPTR) + 1 

Bytes: 1 
Cycles: 2 



Flags: 



C AC F0 RS1 RS0 OV 



PSW 



Description: This instruction increments the 16-bit contents of the data pointer 
by 1 . It places the result in the data pointer. 



Example: INC DPTR 
Encoded Instruction: 



; Increment data pointer 



| 1 1 iT 



7 
Before 
Data Pointer 



After 

Data Pointer 



| 00001001 
15 8 

Notes: None 



11111111 



00001010 
15 8 



00000000 



Instruction Set 3-5 1 




Increment Register 



Mnemonic: INC 
Operands: Rr 



Register <=r<= 7 



INC Rr 



Bit Pattern: 



1 r r r~j 



7 

Operation: (Ftr) - (Rr) + 1 

Bytes: 1 
Cycles: 1 



Flags: 



C AC FO RS1 RSO OV 



PSW 



Description: This instruction increments the contents of register r by 1 . It 
the result in the specified register. 



Example: INC R7 

Encoded Instruction: 



; Increment register7 



00001111 



Register 7 



10101011 
7 

Notes: None 



After 

Register 7 



10101100 
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INC 

Increment Memory 



INC 



Operands: data.address <= data address <= 255 
Format: INC data address 

Bit Pattern: 



00000101 



Data Address 



Operation: 

Bytes: 2 
Cycles: I 

Flags: 



7 7 

(data address) — (data address) + 1 

C AC F0 RS1 RS0 OV P 



PSW 

Description: This instruction increments the contents of the specified data 
address by 1 . It places the result in the addressed location. 



Example: INC 37H 

Encoded Instruction: 



; Increment 37H 



| 00000101 | 001 1 01TT 



7 

Before 
(37H) 



After 
(37H) 



11011110 
7 

Note: 9 



11011111 



Instruction Set 3-53 



JB 

Jump if Bit Is Set 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



JB 

bit address <= bit address <= 255 
code address 

JB bit address, code address 



001 00000 Bit Address Rel. Offset 



Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



(PC) - (PC) + 3 
IF (bit address) = 1 
THEN 

(PC) - (PC) + relative offset 



C AC F0 RS1 RS0 OV 



PSW 

This instruction tests the specified bit address. If it is I, control 
passes to the specified code address. Otherwise, control passes to 
the next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 
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JB 

Example: 



JB39.6,EXIT ; Jump if bit 6 of byte 39 is 1 



SJMPTOP 
EXIT: MOV A, 39 



; Move 39 to accumulator (EXIT label 
; is 5 bytes from jump statement) 



Encoded Instruction: 



00100000 



00111110 | 000000 1 0"] 



7 7 

Before 

(39) 

| 011101 lT~| 
76 

Program Counter 



7 
After 
(39) 



| 00000000 | 11011100 
15 8 7 

Notes: 10, 11, 12 



01110111 



76 
Program Counter 



00000000 



15 



8 



11100001 
7 



Instruction Set 3-55 



JBC 

Jump and Clear if Bit Is Set 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



JBC 

bit address <= bit address <= 255 
code address 

J BC bit address, code address 



001 000 Bit Address Rel. Offset 











(PC) -(PC) + 3 
IF {bit address) = 1 
THEN 

(bit address) — 

(PC) — (PC) + relative offset 



C AC F0 RS1 RS0 OV 



PSW 

This instruction tests the specified bit address. If it is 1, the bit is 
cleared, and control passes to the specified code address. Other- 
wise, control passes to the next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 
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JBC 

Example: 



ORG ODCH 

JBC 46.1, OUT3 ; Test bit 1 of byte 46 
; jump and clear if 1 



ORG136H 
OUT3: INCR7 



Encoded Instruction: 



| 00010000 | 01110001 



01010111 



7 

Before 
(46) 



01 1 1 01 1 1~| 



7 1 

Program Counter 



7 
After 
(46) 

| 01110101 | 
7 1 

Program Counter 



00000000 



11011100 



15 8 7 

Notes: 10, 11, 12 



00000001 



00110110 



15 



8 



Instruction Set 3-57 



JC 

Jump if Carry Is Set 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 



JC 

code address 
JC code address 



01 000000 | Rel.OffseT 



Operation: 



Bytes: 2 
Cycles: 2 



Flags: 



Description: 



(PC) -(PC) + 2 
IF (C) = 1 
THEN 

(PC) - (PC) + relative code 



C AC F0 RS1 RS0 OV 



PSW 

This instruction tests the contents of the carry flag. If it is 1, then 
control passes to the specified code address. Otherwise, control 
passes to the next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 
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Example: 



FIXUP: CLR C 



; Clear carry 



JC FIXUP ; If carry is 1 go to FIXUP 

; 49 bytes backwards from the JC 
; instruction 



Encoded Instruction: 



| 010000 



00 



11001101 



7 

Before 
Carry Flag 



After 

Carry Flag 



I] 



1 



Program Counter Program Counter 

[00000101 | 11011100 | | 00000101 | 10101011 
15 8 7 15 8 7 



Notes: 10, 11, 12 



Generic Jump 



Mnemonic: 

Operands: 

Format: 

Bit Pattern: 

Operation: 

Bytes: 
Cycles: 

Flags: 



Description: 



Example: 



JMP 

code address <= code address <= 65,535 
JMP code address 

Translated to AJMP, LJMP, orSJMP, as needed 
Either AJMP, SJMP or LJMP 

C AC FO RS1 RSO OV P 



PSW 

This instruction will be translated to SJMP if the specified code 
address contains no forward references and that address falls 
within -128 and +127 of the address of the next instruction. It will 
be translated to AJMP if the code address contains no forward 
references and the specified code address falls within the current 2K 
byte page. Otherwise, the JMP instruction is translated to LJMP. 
If forward references are used to specify the jump destination, then 
it will not necessarily be the most efficient representation. See the 
descriptions for SJMP, AJMP, and LJMP for more detail. 



JMP SKIP 
FF: INC A 
SKIP: INCR5 



; Jump to SKIP 

; Increment A 

; Increment register 5 



Encoded Instruction: 



| 00000010 | 00000100 | 10101011 | 



7 7 

Before 

Program Counter 



7 
After 

Program Counter 



00000100 
15 8 

Notes: None 



10100111 



00000100 



10101011 



15 



8 
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Jump to Sum of Accumulator and Data Pointer 



JMP 

A Accumulator 
DPTR Data Pointer 

JMP@A + DPTR 

01110011 | 
7 

(PC) - (A) + (DPTR) 

C AC F0 RS1 RSO OV P 

rrr i i i i i i 

PSW 

This instruction adds the contents of the accumulator with the 
contents of the data pointer. It transfers control to the code address 
formed by that sum. 

JMP @A + DPTR ; Jump relative to the accumulator 
Encoded Instruction: 

| 01 1 1 001 1~ 
7 



Before 




After 




Accumulator 




Accumulator 




01110110 




01110110 




7 




7 




Data Pointer 




Data Pointer 




00000010 


10101000 


00000010 


10101000 


15 8 


7 


15 8 


7 


Program Counter 


Program Counter 


11001101 


00001101 


00000011 


00011110 ] 


15 8 


7 


15 8 


7 



Notes: None 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: I 
Cycles: 2 

Flags: 

Description: 



Instruction Set 3—6 1 



JNB 

Jump if Bit Is Not Set 



Mnemonic: JNB 



Operands: 

Format: 
Bit Pattern: 



bit address 
code address 

JNB bit address ,code address 



00110000 



Bit Address 



Rel. Offset 



Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



(PC) - (PC) + 3 
IF (bit address) = 
THEN 

(PC) - (PC) + relative offset 



C AC F0 RS1 RS0 OV 



PSW 

This instruction tests the specified bit address. If it is 0, control 
passes to specified code address. Otherwise, control passes to the 
next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 
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JNB 



ORG ODCH 

JNB41.6.EXIT ; If bit 6 of byte 41 isOgotoEXIT 



EXIT: ADD A, 41 ; At location 136H 
Encoded Instruction: 

| 00110000 | 01001110 | 01010111 | 
7 7 7 

Before After 

(41) (41) 



00110111 00110111 



76 76 



Program Counter Program Counter 

| 00000000 | 11011100 | | 00000001 | 00110110 | 



15 8 7 15 8 7 

Notes: 10, 11, 12 



Instruction Set 3-63 



JNC 

Jump if Carry Is Not Set 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 



JNC 

code address 
JNC code address 



1 1 0000 Rel. Offset 



Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



(PC) -(PC) + 2 
IF(C) = 
THEN 

(PC) - (PC) + relative offset 



C AC F0 RS1 RS0 OV 



PSW 

This instruction tests the contents of the carry flag. If it is 0, control 
passes to the specified code address. Otherwise, control passes to 
the next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to jhe 
incremented program counter, and the instruction at that address is 
executed. 



3-64 MCS®-51 Macro Assembler 



Example: 



FIXUP: MOVA.R5 



JNCFIXUP ; Jump to FIXUP if carry is 
; (51 bytes backwards) 



Encoded Instruction: 



01010000 11001101 



7 

Before 
Carry Flag 

m 



Program Counter 



00011100 



11011100 



15 8 7 

10, 11, 12 



After 

Carry Flag 







Program Counter 



00011100 



10101011 



15 



8 



Instruction Set 3-65 



JNZ 

Jump if Accumulator Is Not Zero 



Mnemonic: JNZ 
Operands: code address 



Format: 
Bit Pattern: 



JNZ code address 



01110000 



Rel. Offset 



Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



Description: 



(PC) -(PC) + 2 
IF (A)<>0 
THEN 

(PC) - (PC) + relative offset 



C AC F0 RS1 RS0 OV 



PSW 

This instruction tests the accumulator. If it is not equal to 0, 
control passes to the specified code address. Otherwise, control 
passes to the next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
accumulator is not 0, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



3-66 MCS®-51 Macro Assembler 



Example: 



JNZTEST ; Jump if accumulator is not 
; 77 bytes forward 



TEST: MOV R3,A 
Encoded Instruction: 



| 1 1 1 0~ 



01001101 



7 7 

Before 

Accumulator 
| 01 1 1 01 lT~| 
7 

Program Counter 

| 00000000 | 11011100 



After 

Accumulator 



15 8 7 

Notes: 10. 11, 12 



01110111 



7 
Program Counter 



00000001 



00101011 



15 



3 



Instruction Set 3-67 



JZ 

Jump if Accumulator Is Zero 



Mnemonic: JZ 
Operands: code address 



Format: 
Bit Pattern: 



JZ code address 



01100000 



Rel. Offset 



Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



Description: 



(PC) -(PC) + 2 
IF(A) = 
THEN 

(PC) - (PC) + relative offset 



C AC F0 RS1 RS0 OV 



PSW 

This instruction tests the accumulator. If it is 0, control passes to 
the specified code address. Otherwise, control passes to the next 
sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
accumulator is 0, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



3-68 MCS®-51 Macro Assembler 



JZ 

Example: 



JZ EMPTY ; Jump to EMPTY if accumulator is 



EMPTY: INC A 

Encoded Instruction: 

| 01100000 | 00010111 | 
7 7 

Before After 

Accumulator Accumulator 



; 25 bytes from JZ instruction 



01 1 1 01 1 0~| 



01110110 



7 
Program Counter 



7 
Program Counter 



00001111 



11011100 



15 8 7 

Notes: 10, 11, 12 



00001111 
15 8 



11011110 



Instruction Set 3-69 



LCALL 

Long Call 

Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



LCALL 

code address <= code address <= 65,535 
LCALL code address 



01 1 Code Addr. high Code Addr. low 



7 7 

(PC) -(PC) + 3 
(SP)-(SP) + 1 
((SP)) <- {PC low) 
(SP)-(SP) + 1 
{(SP))- (PC high) 
(PC) «- code address 



7 



C AC F0 RS1 RS0 OV P 



PSW 



Description: 



This instruction stores the contents of the program counter (the 
return address) on the stack, then transfers control to the 16-bit 
code address specified as the operand. 



3-70 MCS -51 Macro Assembler 



LCALL 

Example: SERVICE: INC A 



; Resides at location 233H 



RETI 



ORG 80 DCH 

LCALL SERVICE ; Call SERVICE 



Encoded Instruction: 



00010010 



00000010 



00110011 



7 7 

Before 

Program Counter 



After 

Program Counter 



10000000 



11011100 1 | 00000010 | 001100 iT 



15 8 
Stack Pointer 



00101000 



15 8 
Stack Pointer 



00101010 



(29H) 

| 1 1 1 1 iT 



7 

(2AH) 



| 00000000 
7 

Notes: 1,2,3 



(29H) 

| 110111 lT~| 

7 

(2AH) 



10000000 



Instruction Set 3-71 



Long Jump 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 3 
Cycles: 2 



LJMP 

code address <= code address <= 65,535 
LJMP code address 



000001 Code Addr. high 



Code Addr. low 



7 7 

(PC) *- code address 

C AC F0 RS1 RS0 OV 



7 



PSW 

Description: This instruction transfers control to the 16-bit code address 
specified as the operand. 



Example: 



ORG 800H 
LJMP FAR 



; Jump to FAR 



FAR: INC A 
Encoded Instruction: 



; Current code location (8233H) 



00000010 



10000010 



00110011 



7 7 

Before 

Program Counter 



7 
After 

Program Counter 



00001000 
15 8 

Notes: None 



00000000 



10000010 | 00110011 
15 8 7 



3-72 MCS 9 -51 Macro Assembler 



MOV 

Move Immediate Data to Indirect Address 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



MOV 

Rr 
data 



Register <= r <= 1 
-256 <= data <= + 255 



MOV @Rr,#data 



01 1 1 01 1 r Immediate Data 



7 



Operation: ((Rr)) «=■ data 

Bytes: 2 
Cycles: l 



Flags: 



Description: 



Example: 



C AC F0 RS1 RSO OV 



PSW 

This instruction moves the 8-bit immediate data value to the 
memory location addressed by the contents of register r. 



MOV @R1J01H 



Move 1 to indirect address 



Encoded Instruction: 



01110111 



00000001 



7 
Before 
Register 1 



After 
Register 1 



00010011 



00010011 



(13H) 

| 01 1 1 01 1 T\ 

7 



7 

(13H) 



00000001 



Notes: 4, 15 



Instruction Set 3-73 



MOV 

Move Accumulator to Indirect Address 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 1 

s: I 



MOV 

Hr 
A 

MOV@Rr,A 



Register 0<=r<=1 
Accumulator 



| 1111011/- 



Flags: 



7 

«Rr))-<A) 



C AC FO RS1 RSO OV 



Description 
Example: MOV@R0,A 
Encoded Instruction: 



PSW 

This instruction moves the contents of the accumulator to the 
memory location addressed by the contents of register r. 



; Move accumulator to indirect 
; address 



11110110 







Register 
I 00111000 



(38H) 

| 10011007] 
7 

Accumulator 



After 
Register 



00111000 



7 

(38H) 



01001100 



01001100 



7 

Accumulator 
| 010 011 o~o" 



7 

Note: 15 



3-74 MCS®-51 Macro Assembler 



Memory to Indirect Address 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



MOV 

Rr Register 0<= r<= 1 

data address <= data address <= 255 

MOV @Rr,data address 



1 01 0011 r | Data Addressj 
7 7 



Operation: ({Rr)) «- (data address) 

Bytes: 2 
Cycles: 2 



Flags: 



C AC F0 RS1 RSO OV 



PSW 



Description: This instruction moves the contents of the specified data address to 
the memory location addressed by the contents of register r. 



Example: 



MOV0R1J7H 



; Move the contents of 77H to indirect 
; address 



Encoded Instruction: 



| 1 01 001 1 r 



01110111 



7 

Before 
Register 1 



After 
Register 1 



00001000 



00001000 







(08H) 

| 00110011^ 
7 

(77H) 



(08H) 

| 1 1 111 1 To" 



7 

(77H) 



11111110 
7 

Notes: 8, 15 



1 1 111 11 | 



Instruction Set 3—75 



MOV 

Move Immediate Data to Accumulator 



Mnemonic: MOV 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



A 

data 

MOV A,#data 



Accumulator 

-256 <=data <= +255 



| 0111010 



Immediate Data 



7 7 

(A) *- data 

C AC F0 RS1 RS0 OV 



PSW 

Description: This instruction moves the 8-bit immediate data value to the 
accumulator. 



Example: MOVAJ01H 
Encoded Instruction: 



; Initialize the accumulator to 1 



01110100 



00000001 



7 

Before 
Accumulator 











After 

Accumulator 



00100110 
7 

Notes: 4,5 



00000001 



3-76 MCS-51 Macro Assembler 



MOV 

Move Indirect Address to Accumulator 



Mnemonic: MOV 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: l 
Cycles: 1 

Flags: 



A 
Hr 

MOV A,@Rr 



Accumulator 

)<=/-<=! 



1110011/- 



7 
(A) - Wr)) 

C AC F0 RS1 RSO OV 



PSW 

Description: This instruction moves the contents of the data memory location 
addressed by register r to the accumulator. 



Example: MOVA,@R1 
Encoded Instruction: 



; Move indirect address to 
: accumulator 



11100111 



7 
Before 
Accumulator 



After 

Accumulator 



10000110 



11101000 



| 1 1 1 00"~| 
7 

(1CH) 



7 
Register 1 



00011100 



7 

(1CH) 



11101000 
7 

Notes: 5, 15 



11101000 



Instruction Set 3-77 



MOV 

Move Register to Accumulator 



Mnemonic: MOV 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 1 



A 
Rr 

MOV A,R/- 



Accumulator 
Register 0<=r<= 7 



| 11101 



r r r 



7 
(A) - (Rr) 

C AC F0 RS1 RSO OV 



PSW 

Description: This instruction moves the contents of register r to the 
accumulator. 



Example: MOV A.R6 
Encoded Instruction: 



Move R6 to accumulator 



11101110 



7 

Before 

Accumulator 
| 00101110~| 
7 

Register6 



After 

Accumulator 



10000101 



7 
Register 6 



10000101 



10000101 







3-78 MCS 9 -51 Macro Assembler 



Move Memory to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: l 

Flags: 



MOV 

A Accumulator 

data address <= data address <= 255 

MOV A.data address 



11100101 



Data Address 



7 7 

(A) «- (data address) 

C AC F0 RS1 RSO OV 



PSW 

Description: This instruction moves the contents of data memory at the specified 
address to the accumulator. 



Example: MOVA,P1 
Encoded Instruction: 



; Move the contents of Port 1 to 
; accumulator 



11100101 



10010000 



7 

Before 

Accumulator 
| 001 00 1 1 0~~| 
7 

Port I (90H) 

| 011110 o~T| 

7 



After 

Accumulator 



01111001 



7 

Port I (90H) 
011110 oT~| 



Notes: 5, 



Instruction Set 3-79 



Move Bit to Carry Flag 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 



MOV 

C 

bit address 



Carry Flag 

<= bit address <= 255 



MOV C, bit address 



10100010 



Bit Address 



7 7 

(C) - {bit address) 

C AC F0 RS1 RS0 OV 



PSW 

Description: This instruction moves the contents of the specified bit address to 
the carry flag. 



Example: MOVC.TXD 
Encoded Instruction: 



; Move the contents of TXD to Carry 



10100010 



10110110 



7 I 
Before 
Port 3 (BOH) 



After 

Port 3 (BOH) 



00100010 



00100010 



76 



Carry Flag 

m 



76 
Carry Flag 



: None 



3-80 MCS 8 -51 Macro Assembler 



Move Immediate Data to Data Pointer 



Mnemonic: MOV 



Operands: 

Format: 
Bit Pattern: 



Data Pointer 

data <= data <= 65,535 

MOV DPTR, #cte?a 



10010000 



Imm. Data high 



Imm. Data low 



7 7 

Operation: (DPTR) — data 

Bytes: 3 
Cycles: 2 



7 



Flags: 



C AC F0 RS1 RS0 OV 



PSW 



Description: This instruction moves the 16-bit immediate data value to the data 
pointer. 

Example: MOV DPTR. #0F4FH ; Initialize the data pointer to 0F4FH 
Encoded Instruction: 



10010000 | 01 1 1~T 



01001111 



7 



Data Pointer 
| oooooooo" 

15 8 7 

Notes: None 



7 
After 

Data Pointer 



11011100 







00001111 



01001111 



15 



8 7 



i 



Instruction Set 3-81 



Move Immediate Data to Register 



Mnemonic: MOV 

Operands: Rr 

data 



Register <=/-<= 7 
-256 <= data <= + 255 



Format: 
Bit Pattern: 



MOV Rr.ttdata 



I 01111/- r~ 



Immediate Data 



7 7 

Operation: (Rr) — data 

Bytes: 2 
Cycles: 1 



Flags: 



C AC F0 RS1 RSO OV 



Example: 



PSW 

This instruction moves the 8-bit immediate data value to register r. 
MOVR5J01H ; Initialize register 1 



Encoded Instruction: 



| 01111101 



00000001 



7 7 

Before 
Register 5 



After 
Register 5 



00010011 



00000001 



7 
4 



3-82 MCS -51 Macro Assembler 



MOV 

Move Accumulator to Register 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



MOV 

Rr 
A 

MOV Rr.A 



Register <=r<= 7 
Accumulator 



1 1 1 1 1 rrr 



7 

Operation: (Rr) *- (A) 

Bytes: 1 
Cycles: 1 



Flags: 



C AC FO RS1 RSO OV 



PSW 



Description: This instruction moves the contents of the accumulator to register r. 



Example: 



MOVR7.A 



; Move accumulator to register 7 



Encoded Instruction: 

| 111111 lT~| 
7 

Before 

Register 7 



After 

Register 7 



11011100 



00111000 



7 
Accumulator 



00111000 



7 
Notes: None 



7 

Accumulator 
| 1 1 1 0~0~| 
7 



Instruction Set 3-83 



MOV 

Move Memory to Register 



Mnemonic: MOV 



Operands: 

Format: 
Bit Pattern: 



Rr Register <=/-<= 7 

data address <= data address <= 255 

MOV Rr,data address 



1 01 01 rrr 



Data Address 



7 7 

Operation: (Rr) — (data address) 

Bytes: 2 
Cycles: 2 

C AC F0 RS1 RSO OV 



PSW 

Description: This instruction moves the contents of the specified data address to 
register r. 



Example: MOVR4.69H 
Encoded Instruction: 



I Move contents of 69H to register 4 



| 10101100 | 01101001 



7 
Before 
Register4 



After 

Register 4 



00001010 



11011000 



7 

(69H) 



7 

(69H) 



| 11011000 
7 
Note: 8 



11011000 
7 



3-84 MCS®-51 Macro Assembler 



MOV 

Move Carry Flag to Bit 



Mnemonic: 



MOV 



Operands: bit address <= bit address <= 255 
C Carry Flag 



Format: 
Bit Pattern: 

Operation: 
Bytes: 2 



MOV bit address, C 



10010010 



Bit Address 



7 7 

{bit address) *-{C) 

C AC F0 RS1 RS0 OV 



I I I I I I I T 



PSW 

Description: This instruction moves the contents of the carry flag to the 
specified bit address. 

Example: MOV2FH.7.C ; Move C to bit address 7FH 

Encoded Instruction: 



| 10010010 



01111111 



7 

Before 



(2FH) 

| 01 00 1 1 0" 



After 
(2FH) 



10100110 



7 
Carry Flag 



7 
Carry Flag 



1 



Notes: None 



Instruction Set 3-85 



MOV 

Move Immediate Data to Memory 



Mnemonic: MOV 

Operands: data address <= data address <= 255 
data -256 <= data <= + 255 



Format: 
Bit Pattern: 

Operation: 

Bytes: 3 

■ s: 2 



MOV data address ,#data 
01110101 | Data Address |lmmediate Data 



Flags: 



7 7 

(data address) — data 



C AC FO RS1 RSO OV 

□zr 



7 



PSW 



Description: This instruction moves the 8-bit immediate data value to the 
specified data address. 



Example: 



MOV TMODJ01H ; Initialize Timer Mode to 1 



Encoded Instruction: 



01110101 



10001001 



00000001 



7 7 

Before 
TMOD(89H) 



7 I 
After 

TMOD(89H) 



01110111] 



00000001 



7 
s: 4,9 



3-86 MCS -51 Macro Assembler 



Move Indirect Address to Memory 



Mnemonic: MOV 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 2 

Flags: 



data address <= data address <= 255 
Rr Register 0<=r<=1 

MOV data address , @ Rr 



1 00001 1r | Data Address 



7 7 

{data address) ^((RO) 

C AC F0 RS1 RS0 OV 



PSW 

Description: This instruction moves the contents of memory at the location 
addressed by register r to the specified data address. 



Example: MOV11H,@R1 
Encoded Instruction: 



; Move indirect address to 11 H 



| 1 00001 lT 



00010001 



7 7 

Before 
(11 H) 

| 101001 oT~| 
7 

Register 1 



After 
(11H) 



10010110 



7 
Register 1 



01011000 



01011000 



(58H) 

| 1 001 01 i"o~| 

7 



7 

(58H) 



10010110 



Notes: 9, 15 



Instruction Set 3-87 



MOV 

Move Accumulator to Memory 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 

Description: 



MOV 

data address <= data address <= 255 
A Accumulator 

MOV data ad dress, A 



| 11110101 



Data Address 



7 7 

(data address) — (A) 



C AC F0 RS1 rso ov 



PSW 

This instruction moves the contents of the accumulator to the 
specified data address. 



Example: MOV45H.A 
Encoded Instruction: 



Move accumulator to 45H 



I 1 1 1 1 1 oT 



01000101 



7 
Before 
(45H) 



After 
(45H) 



1 01 1 11 01~| 



10011001 



7 
Accumulator 



7 
Accumulator 



| 1001100T 
7 

Note: 9 



10011001 



3-88 MCS -51 Macro Assembler 



MOV 

i Register to Memory 



Mnemonic: MOV 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 2 

Flags: 



data address <= data address <= 255 
Rr Register <=r<= 7 

MOV data address , Rr 



1 00 1 rr/- | Data Address | 
7 7 



(data address) — (Rr) 



C AC F0 RS1 rso ov 



PSW 

Description: This instruction moves the contents of register r to the specified 
data address. 



Example: MOV TEH, R3 
Encoded Instruction: 



Move R3 to location 7EH 



10001011 



01111110 



7 
Before 
(7EH) 

| 1111011 1 1 
7 

Register 3 



After 
(7EH) 

| 1 001 01 1 "o" | 

7 

Register 3 



10010110 
7 

Note: 9 



10010110 



Instruction Set 3-89 



MOV 

Move Memory to Memory 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 3 
Cycles: 2 

Flags: 

Description: 



MOV 

dataaddressl 
data address2 



<= data addressl <= 255 
<= data address2 <= 255 



MOV data addressl ,data address2 



1 00001 01 |Data Address2 



Data Addressl 



7 7 7 

(data addressl) - (data address2) 



C AC F0 RS1 RS0 OV 



IT 



PSW 

This instruction moves the contents of the source data address 
(data address2) to the destination data address (data addressl). 



Example: MOVB.12H 
Encoded Instruction: 



; Move the contents of 12H to B (F0H) 



10000101 



00010010 



11110000 



7 

Before 
(12H) 







7 
After 
(12H) 



1 1 100101 



11100101 



7 

(F0H) 



7 

(F0H) 



01011101 
7 

Note: 16 



11100101 



3-90 MCS®-51 Macro Assembler 



MOVC 



Move Code Memory Offset from Data Pointer 
to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 2 

Flags: 



MOVC 
A 

DPTR 



Accumulator 
Data Pointer 



MOVC A,@A + DPTR 



| 1 001 OOlT 



7 
(A) -((A) + (DPTR)) 

C AC FO RS1 RSO OV 



PSW 

Description: This instruction adds the contents of the data pointer with the 
contents of the accumulator. It uses that sum as an address into 
code memory and places the contents of that address in the 
accumulator. 

The high-order byte of the sum moves to Port 2 and the low-order 
byte of the sum moves to Port 0. 

Example: MOVC A, @A + DPTR ; Look up value in table 
Encoded Instruction: 



10000011 



7 
Before 
Accumulator 



After 

Accumulator 



00010001 



00011110 



7 
Data Pointer 



7 
Data Pointer 



00000010 



11110001 



00000010 



11110001 



15 



8 







(0302H) 

| 01 1 1 1~0~| 

7 
Notes: 5 



15 
(0302H) 



8 



00011110 



Instruction Set 3—9 1 



MOVC 

Move Code Memory Offset from Program 
Counter to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: l 
Cycles: 2 

Flags: 



Description: 



MOVC 

A 
PC 



Accumulator 
Program Counter 



MOVC A,@A + PC 

| 1 00000lT~| 
7 

(PC) - (PC) + 1 
(A)- ((A) + (PC)) 



C AC FO RS1 RSO OV 



PSW 

This instruction adds the contents of the incremented program 
counter with the contents of the accumulator. It uses that sum as an 
address into code memory and places the contents of that address 
in the accumulator. 



The high-order byte of the sum moves to Port 2 and the low-order 
byte of the sum moves to Port 0. 



3-92 MCS®-51 Macro Assembler 



Example: MOVC A,@A + PC ; Look up value in table 
Encoded Instruction: 



| 1000001T 



7 

Before 

Accumulator 
011101 1 1 



After 

Accumulator 



01011000 



Program Counter 
| 00000010 | 00110001 | 
15 8 7 

(02A8H) 
| 1 1 1 oT 
7 

Notes: 5, 12 



7 

Program Counter 



00000010 



001 10010 



15 
(02A8H) 



8 7 



01011000 



Instruction Set 3-93 



MOVX 

Move Accumulator to External Memory 
Addressed by Data Pointer 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 2 

Flags: 



MOVX 

DPTR 
A 



Data Pointer 
Accumulator 



MOVX@DPTR,A 



11110000 



7 
((DPTR))- (A) 

C AC F0 RS1 RSO OV 



PSW 

Description: This instruction moves the contents of the accumulator to the 
off-chip data memory location addressed by the contents of the 
data pointer. 

The high-order byte of the Data Pointer moves to Port 2, and the 
low-order byte of the Data Pointer moves to Port 0. 

Example: MOVX @ DP TR, A ; Move accumulator at data pointer 
Encoded Instruction: 



| 1 1 1 1 00" 



7 
Before 
Data Pointer 



After 

Data Pointer 



00110000 



00110011 



00110000 



15 



001 1 00 1 1 ~| 



8 



(3033H) 

| 111110 01" 



15 

(3033H) 



8 



Accumulator 



| 01001100 
7 

Accumulator 



01001100 
7 

Notes: None 



01001100 



3-94 MCS -51 Macro Assembler 



MOVX 

Move Accumulator to External Memory 
Addressed by Register 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



Flags: 



Description: 



MOVX 

Rr 
A 



Register 0<=r<=1 
Accumulator 



MOVX @R/-,A 

| 1111001/- | 
7 

Operation: ((Rr))-(A) 

Bytes: 1 
Cycles: 2 



C AC F0 RS1 RSO OV 



PSW 

This instruction moves the contents of the accumulator to the off- 
chip data memory location addressed by the contents of register ;, 
and special function register P2. P2 holds the high order byte of the 
address and register r holds the low order byte. 



Example: 



MOV P2.#0 

MOVX (fi R0,A ; Move accumulator to indirect 

; address 



Instruction Set 3-95 



MOVX 



Example: MOV P2,#0 

MOVX @R0,A ; Move accumulator to indirect 

; address 

Encoded Instruction: 



11100010 
7 

Before 

Register 
| 1 01 11 oob~| 
7 

(00B8H) 
1 1 1 1~ 
7 

Accumulator 
01001100 



After 

RegisterO 
1 01 1 1 00~| 
7 

(00B8H) 
010 011 0~0~ 
7 

Accumulator 
01001100 



7 
Notes: None 



7 
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MOVX 

Move External Memory Addressed by 
Data Pointer to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: l 
Cycles: 2 

Flags: 

Description: 



MOVX 
A 

DPTR 



Accumulator 
Data Pointer 



MOVX A,@DPTR 



11100000 



7 
(A) - ((DPTR)) 

C AC F0 RS1 RS0 OV 



PSW 

This instruction moves the contents of the off-chip data memory 
location addressed by the data pointer to the accumulator. 

The high-order byte of the Data Pointer moves to Port 2, and the 
low-order byte of the Data Pointer moves to Port 0. 



Example: MOVX A,@DPTR 
Encoded Instruction: 



; Move memory at DPTR to 
; accumulator 



11100000 



Accumulator 



10000110 



7 
Data Pointer 



01110011 



After 

Accumulator 



11011100 



15 

(73DCH) 



8 



11101000 



11101000 



7 
Data Pointer 



01110011 



15 
(73DCH) 



11101000 



11011100 



Notes: 5 



Instruction Set 3-97 



MOVX 

Move External Memory Addressed by 
Register to Accumulator 



Mnemonic: MOVX 



Operands: 

Format: 
Bit Pattern: 



A 
Rf 

MOVXA,@R/- 



Accumulator 
Register <=/•<=! 



1 1 1 000 1 /- 



7 
Operation: (A) - ((Rr» 
Bytes: 1 
Cycles: 2 
Flags: 



C AC F0 RS1 RSO OV 



Description: 



PSW 

This instruction moves the contents of the off chip data memory 
location addressed by register r, and special function register P2 to 
the accumulator. P2 holds the high order byte of the address and 
register r holds the low order byte. 
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MOVX 



Example: MOV P2, #55H 
MOVXA.&R1 

Encoded Instruction: 



; Move memory at R1 to accumulate 



1 1 1 0001 1 



7 
Before 
Accumulator 



01010100 



7 

Register 1 



00011100 



(551CH) 

| 1 00 



7 

5 



After 

Accumulator 



00001000 



7 
Register 1 



00011100 



7 
(551CH) 



00001000 



Instruction Set 3-99 



MUL 

Multiply Accumulator by B 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 4 



Description: 



MUL 
AB 

MUL AB 



Multiply/Divide operand 



10100100 



7 
(AB) «- (A) * (B) 

C AC F0 RS1 RS0 OV 



PSW 

This instruction multiplies the contents of the accumulator by the 
contents of the multiplication register (B). Both operands are 
treated as unsigned values. It places the low-order byte of the result 
in the accumulator, and places the high-order byte of the result in 
the multiplication register. 



The carry flag is always cleared. If the high-order byte of the prod- 
uct is not 0, then the overflow flag is set; otherwise, it is cleared. 



3-100 MCS®-51 Macro Assembler 



Example: 



MOV B,#10 
MULAB 



; Move 10 to multiplication register 
; Multiply accumulator by 10 



Encoded Instruction: 



10100100 



7 

Before 

Accumulator 
| 0001 1 1 1 1~| 
7 

Multiplication Register (B) 
| 1 1~0~ 



After 

Accumulator 
| 00110110 | 
7 

Multiplication Register (B) 



00000001 



7 

Overflow 

m 

Notes: 5 



7 
Overflow Flag 



I] 



Instruction Set 3-101 



NOP 

No Operation 



Mnemonic: NOP 



Operands: 



Bit Pattern: 



None 
NOP 



00000000 



7 

Operation: No operation 

Bytes: 1 
Cycles: 1 



Flags: 



C AC FO RS1 RS0 OV 



PSW 



p 



Description: This instruction does absolutely nothing for one cycle. Control 
passes to the next sequential instruction. 



Example: 



NOP 



; Pause one cycle 



Encoded Instruction: 



00000000 





None 
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ORL 

Logical OR Immediate Data to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 

Description: 
Example: 



ORL 
A 

data 



Accumulator 

-256 <= data <= + 255 



ORL AJdata 



01 0001 00 Immediate Data 



7 7 

(A) «- (A) OR data 

C AC FO RS1 RS0 OV 



PSW 

This instruction ORs the 8-bit immediate data value to the contents 
of the accumulator. Bit n of the result is 1 if bit n of either operand 
is 1 ; otherwise bit n is 0. It places the result in the accumulator. 

ORL A.moOWOOB ; Set bit 3 to 1 



Encoded Instruction: 



01000100 



00001000 



7 

Before 







Accumulator 
| 01 1 1 01 1 7 



After 

Accumulator 



01111111 



Notes: 4, 5 



Instruction Set 3-103 



ORL 



I OR Indirect Address to Accumulator 



Mnemonic: ORL 



Operands: 

Format: 
Bit Pattern: 



A 
Rr 

ORL A,@Rr 



Accumulator 
Register 0<=r<=1 



01 000 1 1 /- 



Operation: (A) - (A) OR ((Rr)) 



Bytes: l 
Cycles: 1 

Flags: 



Description: 



C AC F0 RS1 RS0 OV 



PSW 

This instruction ORs the contents of the memory location 
addressed by the contents of register r to the contents of the 
accumulator. Bit n of the result is 1 if bit n of either operand is 1; 
otherwise bit n is 0. It places the result in the accumulator. 



Example: ORL A. 

Encoded Instruction: 



; Set bit to 1 



01000110 



7 
Before 
Accumulator 



After 

Accumulator 



00101000 



00101001 



7 

Register 
| 01 01 001 0~~| 
7 

(52H) 

| oooooooT] 

7 



7 
Register 



01010010 



7 

(52H) 



00000001 



Notes: 5, 15 
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Logical OR Register to Accumulator 



Mnemonic: ORL 



Operands: 

Format: 
Bit Pattern: 



A 
Rr 

ORL A,Rr 



Accumulator 
Register <=/-<= 7 



| 01001 r~F7 



7 

Operation: (A) — (A) OR (Rr) 

Bytes: 1 
Cycles: 1 



Flags: 



C AC F0 RS1 RSO OV 



PSW 



Description: This instruction ORs the contents of register r to the contents of the 
accumulator. Bit n of the result is 1 if bit n of either operand is 1; 
otherwise bit n is 0. It places the result in the accumulator. 



Example: ORL A.R4 
Encoded Instruction: 



: Set bits 7 and 3 to 1 



| 01001100 
7 

Before 

Accumulator 



After 

Accumulator 



10010001 



10011001 



7 
Register 4 



7 
Register 4 



10001000 
7 

Note: 5 



10001000 



Instruction Set 3-105 



Logical OR Memory to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



Flags: 



Description: 



Example: 



ORL 

A Accumulator 

data address <= data address <= 255 



ORL A,data address 

| 1 00 01 01 | Data Address | 
7 7 

Operation: (A) *- (A) OR (data address) 

Bytes: 2 
Cycles: 1 



C AC F0 RS1 RS0 OV 



PSW 

This instruction ORs the contents of the specified data address to 
the contents of the accumulator. Bit n of the result is l if bit n of 
either operand is 1; otherwise bit n is 0. It places the result in the 
accumulator. 



ORL A.37H 



OR 37H with accumulator 



Encoded Instruction: 



01000101 



00110111 



Accumulator 
| 0111 01 1T 



(37H) 

| 1 000000" 
7 



After 

Accumulator 



11110111] 



7 

(37H) 



10000000 



Notes: 5,8 
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ORL 

Logical OR Bit to Carry Flag 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 2 

Flags: 

Description: 
Example: 



ORL 

C 

bit address 



Carry Flag 

0<= bit address <=255 



ORL C, bit address 



| 1 1 1 1~0~ 



Bit Address 



7 7 

(C) *- (C) OR (bit address) 



C AC FO RS1 RSO OV 

•TTT 



PSW 

This instruction ORs the contents of the specified bit address with 
the contents of the carry flag. The carry flag becomes 1 when either 
the carry flag or the specified bit address is 1; otherwise, it is 0. It 
places the result in the carry flag. 



ORL C.46.2 



; OR bit 2 of byte 46 with Carry 



Encoded Instruction: 



01110010 



01110010 







Carry Flag 

m 

(46) 



After 

Carry Flag 



1 



(46) 



00100110 
7 2 

Notes: None 



00100110 
7 2 



Instruction Set 3-107 



ORL 

Logical OR Complement of Bit to Carry Flag 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



ORL 

C 

bit address 



Carry Flag 

0<= bit address <= 255 



ORL C,l bit address 



1 1 000 00 Bit Address 



Operation: (C) - (C) OR NOT (bit address) 



Bytes: 2 
Cycles: 2 

Flags: 



Description: 



C AC F0 RS1 RS0 OV 

[HI 



PSW 

This instruction ORs the complemented contents of the specified 
bit address to the contents of the carry flag. The carry flag is 1 
when either the carry flag is already 1 or the specified bit address is 
0. It places the result in the carry flag. The contents of the specified 
bit address is unchanged. 



Example: ORLC./25H.5 



Encoded Instruction: 



: Complement contents of bit 5 in 
; byte 25H then OR with Carry 



| 10100000 | 00101101 



7 

Before 
Carry Flag 

m 

(25H) 



After 

Carry Flag 

m 

(25H) 



00000110 



00000110 



7 5 
s: None 



7 5 
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ORL 



OR Immediate Data to Memory 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 3 
Cycles: 2 

Flags: 

Description: 



ORL 

data address <= data address <= 255 
data -256 <= data <= + 255 

ORL data address ,#data 



01000011 



Data Address 



Immediate Data 



7 7 7 

(data address) *~ (data address) OR data 

C AC F0 RS1 RS0 OV P 



PSW 

This instruction ORs the 8-bit immediate data value to the contents 
of the specified data address. Bit n of the result is l if bit n of either 
operand is l; otherwise bit n is 0. It places the result in memory at 
the specified address. 



Example: ORL57H,#01H 
Encoded Instruction: 



Set bit to 1 



01000011 01010111 00000001 



7 



(57H) 



7 
After 
(57H) 



01110110 
7 

Notes: 4, 9 



01110111 



Instruction Set 3-109 



ORL 

Logical OR Accumulator to Memory 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: l 

Flags: 

Description: 
Example: 



ORL 

data address <= data address <= 255 
A Accumulator 

ORL data address, A 



01000010 



Data Address 



7 7 

(data address) *- (data address) OR A 



C AC F0 RS1 RS0 OV P 

I I I I □ 



PSW 

This instruction ORs the contents of the accumulator to the 
contents of the specified data address. Bit n of the result is 1 if bit n 
of either operand is 1; otherwise bit n is 0. It places the result in 
memory at the specified address. 



ORL 10H.A 



; OR accumulator with the contents 
; of 10H 



Encoded Instruction: 



01000010 | 00010000 



7 

Before 

Accumulator 
| 11110 o"o~| 
7 

(10H) 

| 001 1 oooT 
7 

Note: 9 



After 

Accumulator 
| 1 1 1 1 0~0~~| 
7 

(10H) 



11110001 
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POP 

Pop Stack to Memory 

Mnemonic: POP 

Operands: data address <= data address <= 255 
Format: POP data address 
Bit Pattern: , 



11010000 



Data Address 



7 7 

Operation: (data address) *- ((SP)) 
(SP)-(SP)-1 



Bytes: 2 
Cycles: 2 

Flags: 



C AC F0 RS1 RS0 OV 



PSW 

Description: This instruction places the byte addressed by the stack pointer 
at the specified data address. It then decrements the stack pointer 
by 1. 



Example: POP PSW 

Encoded Instruction: 

I 11010000 I 11010000 



; Pop PSW parity is not affected. 



7 7 

Before 
Accumulator 
| 1101010 1 | 

7 
PSW(ODOH) 
| 10101011 







After 

Accumulator 
| 1 1 1 1 oT 



7 
PSW(ODOH) 



11110010 



7 
Stack Pointer 



7 
Stack Pointer 



00010000 



00001111 



7 

(10H) 

| 1 1 1 1 001 0~~| 

7 



7 

(10H) 



| 1 1 1 1 o o iT 



Notes: 2, 8, 17 



Instruction Set 3- 111 



PUSH 

Push Memory onto Stack 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



Description: 



PUSH 

data address <= data address <= 255 
PUSH data address 



1 1 000000 Data Address 



7 7 

(SP)-(SP) + 1 

{(SP)) *- (data address) 



C AC F0 RS1 RS0 OV 



PSW 

This instruction increments the stack pointer, then stores the 
contents of the specified data address at the location addressed by 
the stack pointer. 



Example: PUSH4DH 
Encoded Instruction: 



; Push one byte to the stack 



11000000 



01001101 



7 
Before 
(4DH) 

| 101010 1~0~ 
7 

Stack Pointer 



After 
(4DH) 



10101010 



7 
Stack Pointer 



00010000 



00010001 



7 

(11H) 



7 

(11H) 



oooooo o o~l 

7 
Notes: 2,3,8 



10101010 
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RET 

Return from Subroutine (Non-interrupt) 



Mnemonic: RET 
Operands: None 
Format: RET 

Bit Pattern: . 

I 00100010 



Operation: (PC high) — ((SP)) 
(SP) - (SP) -1 
(PC low) - ((SP)) 
(SP) -(SP)-1 

Bytes: l 
Cycles: 2 

Flags: c ac fo rsi rso ov p 



PSW 

Description: This instruction returns from a subroutine. Control passes to the 
location addressed by the top two bytes on the stack. The high- 
order byte of the return address is always the first to come off the 
stack. It is immediately followed by the low-order byte. 



Instruction Set 3-113 



RET 



Example: RET 

Encoded Instruction: 



00100010 



7 
Before 

Program Counter 



00000010 



01010101 



15 



8 



Stack Pointer 
| 01 i"o~ 
7 

(0AH) 



00000000 



(09H) 

| 01110011 
7 

Notes: 2, 17 



; Return from subroutine 



After 



Program Counter 



00000000 



01110011 



15 8 

Stack Pointer 
| 00001000 | 
7 

(0AH) 



00000000 



7 

(09H) 



01110011 
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RETI 

Return from Interrupt Routine 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 



RETI 
None 
RETI 



00110010 



Operation: 



Bytes: I 
Cycles: 2 

Flags: 



Description: 



(PC high) ^((SP)) 
(SP)-(SP) -1 
<PC/ow)-((SP)) 
(SP)-(SP) -1 



C AC FO RS1 RS0 OV 



PSW 

This instruction returns from an interrupt service routine, and 
reenables interrupts of equal or lower priority. Control passes to 
the location addressed by the top two bytes on the stack. The high- 
order byte of the return address is always the first to come off the 
stack. It is immediately followed by the low-order byte. 



Instruction Set 3-115 



RETI 



Example: RETI 
Encoded Instruction: 



00110010 



7 
Before 

Program Counter 



00001010 



10101010 



15 8 

Stack Pointer 
00001010 



7 

(0AH) 







00000000 



7 

(09H) 



11110001 
7 

Notes: 2, 17 



Return from interrupt routine 



After 

Program Counter 



00000000 



11110001 



15 8 
Stack Pointer 



00001000 



7 

(0AH) 







00000000 



7 

(09 H) 



11110001 
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RL 

Rotate Accumulator Left 



Mnemonic: RL 



Operands: 
Format: 
Bit Pattern: 



A 

RL A 



Accumulator 



00100011 



Operation: 



Bytes: 1 
Cycles: 1 

Flags: 



Description: 



Example: 



C ACCUMULATOR 

□ r-QZLZHEIZEr 



C AC F0 RS1 RS0 OV 



PSW 

This instruction rotates each bit in the accumulator one position to 
the left. The most significant bit (bit 7) moves into the least signifi- 
cant bit position (bit 0). 



RLA 



; Rotate accumulator left one positon. 



Encoded Instruction: 



00100011 



7 

Before 

Accumulator 
| 1 1 01 0000" 
7 

Notes: None 



After 

Accumulator 



10100001 



Instruction Set 3-117 



RLC 

Rotate Accumulator and Carry Flag Left 



Mnemonic: RLC 

Operands: A 

Format: RLC A 
Bit 



Accumulator 



00110011 



Operation: 



C 



ACCUMULATOR 



1 

Cycles: 1 
Flags: 



C AC F0 RS1 RSO OV 



PSW 

Description: This instruction rotates each bit in the accumulator one position to 
the left. The most significant bit (bit 7) moves into the Carry flag, 
while the previous contents of Carry moves into the least significant 
bit (bit 0). 



Example: 



RLC A 



; Rotate accumulator and carry left 
; one positon. 



Encoded Instruction: 



| 1 1 00lT 
7 

Before 

Accumulator 
| 0001 1 00 1" 
7 
Carry Flag 

ra 

Note: 5 



After 

Accumulator 



00110011 



7 
Carry Flag 
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RR 

Rotate Accumulator Right 



Operands: A 



Accumulator 



Format: 
Bit Pattern: 



RR A 



00000011 



Operation: 



Bytes: 1 
Cycles: 1 

Flags: 



C 
□ 



ACCUMULATOR 







7 






C AC F0 RS1 RS0 OV 



PSW 

Description: This instruction rotates each bit in the accumulator one position to 
the right. The least significant bit (bit 0) moves into the most 
significant bit position (bit 7). 



Example: 



RRA 



Encoded Instruction: 



; Rotate accumulator right one 
: positon. 



| 00000011 
7 

Before 

Accumulator 



| 1 1 01 oooT 
7 



After 

Accumulator 



| 111010 0~0~ 
7 



: None 



Instruction Set 3-119 



RRC 

Rotate Accumulator and Carry Flag Right 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 1 
Cycles: 1 



Flags: 



Description: 



Example: 



RRC 
A 

RRC A 



Accumulator 



00010011 



7 
C 



ACCUMULATOR 



C AC F0 RS1 RS0 OV 



PSW 

This instruction rotates each bit in the accumulator one position to 
the right. The least significant bit (bit 0) moves into the Carry flag, 
while the previous contents of Carry moves into the most signifi- 
cant bit (bit 7). 



RRC A 



; Rotate accumulator and carry right 
; one positon. 



Encoded Instruction: 



00010011 



7 
Before 
Accumulator 



After 

Accumulator 



10011000 



11001100 



7 
Carry Flag 







n 



Carry Flag 

m 



Note: 5 
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Set Carry Flag 



Operands: 



SETB 

C 

SETB C 



Carry Flag 



Bit Pattern: 



Operation: 

Bytes: l 
Cycles: l 

Flags: 



11010011 



7 

(C)-1 



C AC F0 RS1 RSO OV 

"•TTT 



PSW 

Description: This instruction sets the carry flag to 1 . 
Example: SETBC ; Set Carry to 1 

Encoded Instruction: 



| 1 1 1 iT 



7 

Before 



After 



Carry Flag 

m 

Notes: None 



Carry Flag 

m 



Instruction Set 3-121 



SETB 

Set Bit 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



SETB 

bit address <= bit address <= 255 
SETB bit address 



11010010 



Bit Address 



7 7 

{bit address) — y 

C AC FO RS1 RS0 OV 



PSW 

Description: This instruction sets the contents of the specified bit address to 1 . 



Example: SETB 41.5 
Encoded Instruction: 



; Set the contents of bit 5 in byte 41 
;to1 



| 11010010 



01001101 



7 

Before 
(41) 



After 
(41) 



| 01000110 
7 5 

Notes: None 



01100110 
7 5 
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Short Jump 



Mnemonic: SJMP 



Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 

' s: 2 



Flags: 



Description: 



Example: 



code address 
SJMP code address 

| 1 0000000 | Rel. Offset | 
7 7 

(PC) -(PC) + 2 

(PC) - (PC) + relative offset 



C AC F0 RS1 RS0 OV 



PSW 

This instruction transfers control to the specified code address. The 
Program Counter is incremented to the next instruction, then the 
relative offset is added to the incremented program counter, and 
the instruction at that address is executed. 

SJMP BOTTOM ; Jump to BOTTOM 
FF: INC A 



BOTTOM: RR A 



; (15 bytes ahead from the INC 
instruction) 



Encoded Instruction: 



10000000 



00001111 



7 7 

Before 

Program Counter 







After 

Program Counter 



| 1 1 1 1 | 110111 oT 
15 8 7 

Notes: 10, 11, 12 



11101000 



11101101 



15 



8 



Instruction Set 3-123 



SUBB 

Subtract Immediate Data from 
Accumulator with Borrow 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: l 



SUBB 

A 

data 

SUBB k.tdata 



Accumulator 

-256 <= data <= +255 



10010100 



Immediate Data 



7 7 

(A) - (A) - (C) - data 

C AC F0 RS1 RS0 OV 



Description: 



PSW 

This instruction subtracts the contents of the Carry flag and the 
immediate data value from the contents of the accumulator. It 
places the result in the accumulator. 

; Subtract 0C1 H from accumulator 



Example: SUBBAJ0C1H 

Encoded Instruction: 

| 10010100 | 01100100 | 
7 7 

Before After 

Accumulator Accumulator 



00100110 



01100100 



Carry Flag 

m 

Auxiliary Carry Flag 



Overflow Flag 

m 

Notes: 4,5,6, 13, 14 



Carry Flag 

m 

Auxiliary Carry Flag 

m 

Overflow Flag 
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Subtract Indirect Address from 
Accumulator with Borrow 



Operands: 

Format: 
Bit Pattern: 



SUBB 

A 
Hr 



Accumulator 
Register 0<=r<=l 



SUBB A,@Rr 



1001011/-] 



7 

Operation: (A) *- (A) - (C) - ((Rr)) 

Bytes: 1 
Cycles: 1 



Flags: 



C AC FO RS1 RSO OV 



PSW 



Description: 



This instruction subtracts the Carry flag and the memory location 
addressed by the contents of register r from the contents of the 
accumulator. It places the result in the accumulator. 



Instruction Set 3-125 



SUBB 

Example: SUBB A, 

Encoded Instruction: 

| 1 001 01 lT~| 
7 

Before 

Accumulator 



10000110 



7 
Register 1 



00011100 



7 

(1CH) 



01100010 



7 
Carry Flag 



Auxiliary Carry Flag 

Overflow Flag 
~0~ 



Notes: 5,6, 13, 14, 15 



; Subtract the indirect address from 
; accumulator 



After 

Accumulator 



00100100 



7 
Register 1 



00011100 



(1CH) 

| 01100010 
7 
Carry Flag 



Auxiliary Carry Flag 

m 

Overflow Flag 

CD 
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Subtract Register from Accumulator with Borrow 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: l 
Cycles: 1 

Flags: 

Description: 



SUBB 

A 
Rr 

SUBB A,Rr 



Accumulator 
Register <=r<= 7 



| 10 011/- r~ 



7 
(A) - (A) - (C) - (Rr) 

C AC F0 RS1 RSO OV 



PSW 

This instruction subtracts the contents of the Carry flag and the 
contents of register r from the contents of the accumulator. It 
places the result in the accumulator. 



Instruction Set 3-127 



SUBB 



Example: SUBBA.R6 
Encoded Instruction: 



10011110 



7 
Before 
Accumulator 



01110110 



7 
R6 



10000101 



; Subtract R6 from accumulator 



After 

Accumulator 



11110000 



7 
R6 



10000101 



Carry Flag 

m 

Auxiliary Carry Flag 

m 

Overflow Flag 



Carry Flag 

m 

Auxiliary Carry Flag 

m 

Overflow I 

m 



Notes: 5, 6, 13, 14 
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Ql IRR 
OUDD 

Subtract Memory from Accumulator with Borrow 



Mnemonic: 
Operands: 

Formal: 
Bit Pattern: 



SUBB 

A Accumulator 

data address <= data address <= 255 



SUBB k,data address 

| 10010101 | Data Address | 
7 7 

Operation: (A) *- ( A) - (C) - {data address ) 

Bytes: 2 
Cycles: 1 



Flags: 



Description: 



C AC F0 RS1 RS0 OV 



PSW 

This instruction subtracts the contents of the Carry flag and the 
contents of the specified address from the contents of the 
accumulator. It places the result in the accumulator. 
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SUBBA,32H 
Encoded Instruction: 



; Subtract 32H in memory from 
; accumulator 



10010101 



00110010 



7 



Accumulator 



00100110 



(32H) 

| 01010011 



7 
Carry Flag 

m 



Auxiliary Carry Flag 

m 

Overflow Flag 
Notes: 5,6,8, 13, 14 



After 

Accumulator 



11010010 



7 

(32H) 



01010011 



7 
Carry Flag 



1 



Auxiliary Carry Flag 

m 

Overflow Flag 

d3 
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SWAP 

Exchange Nibbles in Accumulator 



Mnemonic: SWAP 

Operands: A 

Format: SWAP A 
Bit Pattern: 



Accumulator 



11000100 



Operation: 



Bytes: 1 
Cycles: 1 

Flags: 



| h h h h I III 



J 



C AC F0 RS0 RS1 OV 



PSW 

Description: This instruction exchanges the contents of the low order nibble 
(0-3) with the contents of the high order nibble (4-7). 



Example: SWAP A 
Encoded Instruction: 



; Swap high and low nibbles in the 
; accumulator. 



11000100 



7 
Before 
Accumulator 



After 

Accumulator 



| 1 1 1 000 

7 

Notes: None 



00001101 
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XCH 

Exchange Indirect Address with Accumulator 



Mnemonic: XCH 



Operands: 

Format: 
Bit Pattern: 



A 

Rr 

XCH A,@Rr 



Accumulator 
Register 0<=r<=1 



| 1 1 0001 1 /- | 
7 

Operation: temp — ((Rr)) 
((Rr))-(A) 



(A) ■«- temp 



Bytes: 1 
Cycles: 1 

Flags: 



C AC FO RS1 RSO OV 



PSW 

Description: This instruction exchanges the contents of the memory location 
addressed by the contents of register r with the contents of the 
accumulator. 



Example: XCH A.@R0 
Encoded Instruction: 



: Exchange the accumulator with 
; memory 



11000110 



7 

Before 

Accumulator 
| 011111 1 | 
7 

RegisterO 



After 

Accumulator 



0001 1 1 01~| 



7 
RegisterO 



01010010 



01010010 



(52H) 

| 1 1 1 1~| 

7 



7 
(52H) 

| 01111 1~T| 
7 



Notes: 5, 15 
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Exchange Register with Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



XCH 

A 
Rr 

XCH A.Rr 



Accumulator 
Register <=/"<= 7 



1 1 001 rrr 



Operation: temp — (Rr) 
(Rr) - (A) 
(A) *- temp 

Bytes: l 
Cycles: 1 



C AC F0 RS1 RSO OV 



PSW 

Description: This instruction exchanges the contents of register r with the 
contents of the accumulator. 



Example: XCHA.R6 
Encoded Instruction: 



| 110 011 0~0~ 



; Exchange register 6 with the 
; accumulator 



Accumulator 



1 001 1 001 | 



7 
Register 6 



| 10000000 
7 

Note: 5 



After 

Accumulator 



10000000 



7 
Register 6 



10011001 



Instruction Set 3— 1 33 



XCH 

Exchange Memory with Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



XCH 

A Accumulator 

data address <= data address <= 255 

XCH A,data address 



| 1 1 0001 01 | Data Address 



7 7 

Operation: temp — (data address) 
(data address) — (A) 
(A) - temp 

Bytes: 2 
Cycles: l 



C AC F0 RS1 RSO OV 



n 



PSW 

Description: This instruction exchanges the contents of the specified data 
address with the contents of the accumulator. 



Example: 



XCH A, 37 H 



; Exchange accumulator with the 
; contents of location 37H 



Encoded Instruction 
| 1 1 1 01 



00110111 



7 
Before 
Accumulator 







01110111 



After 

Accumulator 
| 1 1 1 1 oT 



7 

(37H) 



7 

(37H) 



11110000 
7 

Notes: 5,9 



01110111 
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XCHD 

Exchange Low Nibbles (Digits) of Indirect 
Address with Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



XCHD 

A 
Rr 



Accumulator 
Register 0<=r<=1 



XCHD A,@Rr 



1 1 01 01 1 r 



Operation: 



temp -((Rr)) 0-3 
((Rr)) 0-3 - (A) 0-3 
(A) 0-3 -temp 



Bytes: 1 
Cycles: 1 



Flags: 



C AC FO RS1 RS0 OV 



PSW 



Description: This instruction exchanges the contents of the low order nibble (bits 
0-3) of the memory location addressed by the contents of register r 
with the contents of the low order nibble (bits 0-3) of the 
accumulator. 



Instruction Set 3- 1 35 



XCHD 



Example: XCHDA,@R0 

Encoded Instruction: 

| 110101 10~| 
7 

Before 

Accumulator 



00111 1 1 jj 



7 
Register 



01010010 



7 

(52H) 



000111 01 | 
7 
Notes: 5, 15 



; Exchange the accumulator with 
; memory 



After 

Accumulator 
011110 1 [ 



7 
Register 



01010010 



7 

(52H) 



00011111 
7 
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XRL 

Logical Exclusive OR Immediate Data 
to Accumulator 



Mnemonic: XRL 



Operands: 

Format: 
Bit Pattern: 



A 

data 

XRLA,#dafa 



Accumulator 
-256 <= data <= 



+ 255 



01100100 



Immediate Data 



7 7 

Operation: (A) ~ (A) XOR data 



C AC F0 RS1 RS0 OV 



Cycles: 1 
Flags: 

Description: 



PSW 

This instruction exclusive ORs the immediate data value to the 
contents of the accumulator. Bit n of the result is if bit n of the 
accumulator equals bit n of the data value; otherwise bit n is 1. It 
places the result in the accumulator. 



Example: XRL A,#0FH 

Encoded Instruction: 

| 01 1 001 00 | 0000 1 1~ 
7 7 



; Complement the low order nibble 



Accumulator 



After 

Accumulator 



| 01110111' 
7 



01111000 



Notes: 4, 5 



Instruction Set 3- 1 37 



XRL 

Logical Exclusive OR Indirect Address 
to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



XRL 

A 
Rr 

XRL A,@Rr 



Accumulator 
0<= Rr<=1 



0110011/- 



Operation: (A) - (A) XOR [(Rr)) 

Bytes: 1 
Cycles: 1 



Flags: 



Description: 



Example: 



C AC F0 RS1 RSO OV 



PSW 

This instruction exclusive ORs the contents of the memory location 
addressed by the contents of register r to the contents of the 
accumulator. Bit n of the result is if bit n of the accumulator 
equals bit n of the addressed location; otherwise bit n is 1 . It places 
the result in the accumulator. 



XRLA,@R0 



; XOR indirect address with 
; accumulator 



Encoded Instruction: 



01100110 



7 
Before 
Accumulator 



00101000 



7 
Register 



01010010 



7 
(52H) 



00000001 
7 

Notes: 5, 15 



After 

Accumulator 



00101001 



7 
Register 



01010010 



7 

(52H) 



00000001 
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XRL 

Logical Exclusive OR Register to Accumulator 



Mnemonic: XRL 



Operands: 

Format: 
Bit Pattern: 



A 
Rr 

XRLA.Rr 



Accumulator 
Register <= r <= 7 



| 011 01 rr~ 



7 

Operation: (A) — (A) XOR (Rr) 

Bytes: 1 
Cycles: 1 

C AC F0 RS1 RSO OV 



Description: 



PSW 

This instruction exclusive ORs the contents of register r to the 
contents of the accumulator. Bit n of the result is if bit n of the 
accumulator equals bit n of the specified register; otherwise bit n is 
1 . It places the result in the accumulator. 



Example: XRL A , R4 

Encoded Instruction: 



; XOR R4 with accumulator 



01101100 



7 
Before 
Accumulator 



After 

Accumulator 



10010001 



01110010 



7 
Register 4 



7 
Register 4 



11100011 



11100011 



7 

5 
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XRL 

Logical Exclusive OR Memory to Accumulator 



Mnemonic: XRL 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: l 



A Accumulator 

data address <= data address <= 255 

XRL K,data address 



| 0110 0101 



Data Address 



7 7 

(A) - (A) XOR (data address) 

C AC F0 RSI RS0 OV P 



PSW 

Description: This instruction exclusive ORs the contents of the specified data 
address to the contents of the accumulator. Bit n of the result is if 
bit n of the accumulator equals bit n of the addressed location; 
otherwise bit n is 1 . It places the result in the accumulator. 



Example: 



XRLA.37H 



; XOR the contents of location 37H 
; with accumulator 



Encoded Instruction: 



01100101 



00110111 



7 7 

Before 

Accumulator 
| 011111 iT 



After 

Accumulator 
| 111101 1~ 



7 

(37H) 



7 

(37H) 



10001000 
7 

Notes: 4,8 



10001000 
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XRL 

Logical Exclusive OR Immediate Data to Memory 



Mnemonic: XRL 



Operands: 

Format: 
Bit Pattern: 



data address 
data 



<= data address <= 255 
-256 <= data <= +255 



XRL data address Mata 



| 01 1 0001 1 | Data Address |lmmediate Data" 



7 7 7 

Operation: (data address) - (data address) XOR data 

Bytes: 3 
Cycles: 2 



Flags: 



Description: 



C AC FO RS1 RS0 OV 



PSW 

This instruction exclusive ORs the immediate data value to the 
contents of the specified data address. Bit n of the result is if bit n 
of the specified address equals bit n of the data value; otherwise, 
bit n is l . It places the result in data memory at the specified 
address. 



Example: XRLP1J51H 
Encoded Instruction: 



I XOR 51 H with the contents of Port 1 



| 01100011 | 10010000 | 01010001 



Before 
Portl (90H) 



| o 1 1 1 o 1 iT 

7 



After 

Portl (90H) 



00100111 



Notes: 4, 9 
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XRL 

Logical Exclusive OR Accumulator to Memory 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



XRL 

data address <= data address <= 255 
A Accumulator 

XRL data address, A 

| 1 1 000 1 I Data Address I 
7 7 



Operation: (data address) *- (data address) XOR A 

Bytes: 2 
Cycles: 1 

C AC F0 RS1 RS0 OV P 



Description: 



Example: 



PSW 

This instruction exclusive ORs the contents of the accumulator to 
the contents of the specified data address. Bit n of the result is if 
bit n of the accumulator equals bit n of the specified address; 
otherwise bit n is 1. It places the result in data memory at the 
specified address. 



XRL 10H.A 



; XOR the contents of 10H with the 
; accumulator 



Encoded Instruction: 



01100010 



00010000 



7 7 

Before 

Accumulator 
| 1 1 1 1 00 | 
7 

(10H) 



After 

Accumulator 
| 1 1 1 1 00" 



7 

(10H) 



00110001 
7 

Note: 9 



11000001 
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Notes 

1. The low-order byte of the Program Counter is always placed on the stack first, 
followed by the high order byte. 

2. The Stack Pointer always points to the byte most recently placed on the stack. 

3. On the 8051 the contents of the Stack Pointer should never exceed I27. If the 
stack pointer exceeds 1 27, data pushed on the stack will be lost, and undefined 
data will be returned. The Stack Pointer will be incremented normally even 
though data is not recoverable. 

4. The expression used as the data operand must evaluate to an eight-bit number. 
This limits the range of possible values in assembly time-expressions to between 
—256 and +255 inclusive. 

5. The Parity Flag, PSW.O, always shows the parity of the accumulator. If the 
number of l's in the accumulator is odd, the parity flag is I; otherwise, the 
parity flag will be 0. 

6. All addition operations affect the Carry Flag, PSW.7, and the Auxiliary Carry 
flag, PSW.6. The Carry flag receives the carry out from the bit 7 position (Most 
Significant Bit) in the accumulator. The Auxiliary Carry flag receives the carry 
out from the bit 3 position. Each is either set or cleared with each ADD 
operation. 

7. The overflow flag (OV) is set when an operation produces an erroneous result 
(i.e. the sum of two negative numbers is positive, or the sum of two positive 
numbers is negative). OV is updated with each operation. 

8. If one of the I/O ports is specified by the data address, then data will be taken 
from the port input pins. 

9. If one of the I/O ports is specified by the data address, then data will be taken 
from, and returned to, the port latch. 

10. The code address operand must be within the range of - 1 28 and +127 inclusive 
of the incremented program counter's value. 

11. The last byte of the encoded instruction is treated as a two's complement 
number, when it is added to the program counter. 

12. The Program Counter is always incremented before the add. 

13. The auxiliary carry flag is set if there is a borrow from bit 3 of the accumulator; 
otherwise, it is cleared. 

14. The overflow flag (OV) is set when an operation produces an erroneous result 
(i.e. a positive number is subtracted from a negative number to produce a 
positive result, or a negative number is subtracted from a positive number to 
produce a negative result). OV is cleared with each correct operation. 

15. On the 8051 the contents of the register used in the indirect address should not 
exceed 127. When the contents of the register is 128 or greater, source operands 
will return undefined data, and destination operands will cause data to be lost. 
In either case, the program will continue with no change in execution time or 
control flow. 

16. If an I/O port is specified as the source operand, then the the port pins will be 
read. If an I/O port is the destination operand, then the port latch will receive 
the data. 

17. If the stack pointer is 128 or greater, then invalid data will be returned on a 
POP or return. 



Assembler Directives 



This chapter describes the assembler directives. It shows how to define symbols and 
how to control the placement of code and data in program memory. 



Introduction 

The MCS-51 assembler has several directives that permit you to set symbol values, 
reserve and initialize storage space, and control the placement of your code. 

The directives should not be confused with instructions. They do not produce exe- 
cutable code, and with the exception of the DB and DW directives, they have no 
direct effect on the contents of code memory. What they do is change the state of the 
assembler, define user symbols, and add information (other than pure object code) 
to the object file (e.g., segment definitions). 

The directives are divided into the following categories: 

Svmbol Definition 
SEGMENT 
EQU 
SET 
DATA 
IDATA 
XDATA 
BIT 
CODE 

Storage Initialization/ Reservation 
DS 
DB 
DW 
DB1T 

Program Linkage 
PUBLIC 
EXTRN 
NAME 

Assembler State Control 
ORG 
END 

Segment Selection Directives 

RSEG 

CSEG 

DSEG 

XSEG 

1SEG 

BSEG 

USING 

The MCS-51 assembler is a two-pass assembler. In the first pass, symbol values are 
determined, and in the second, forward references are resolved, and object code is 
produced. This structure imposes a restriction on the source program: expressions 
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which define symbol values (see Symbol Definition Directives) and expressions 
which control the location counter (see ORG, DS, and DBIT directives) may not 
have forward references. 



The Location Counter 

The location counter in ASM51 is a pointer to the address space of the active seg- 
ment. When a segment is first activated, the location counter is (unless a base 
address was specified using the segment select directives). The location counter is 
changed after each instruction by the length of the instruction. You can change its 
value with the ORG directive, which sets a new program origin for statements that 
follow it. The storage initialization and reservation directives (DS, DB, DW, and 
DBIT) change the value of the location counter as statements are encountered within 
a segment. If you change segments and later return to that segment, the location 
counter is restored to its previous value. Whenever the assembler encounters a label, 
it assigns to the label the current value of the location counter and the type of the 
current segment. 

The dollar sign ($) indicates the value of the active segment's location counter. 
When you use the location counter symbol, keep in mind that its value changes with 
each instruction, but only after that instruction has been completely evaluated. If 
you use $ in an operand to an instruction or a directive, it represents the code 
address of the first byte of that instruction. 

MSG: DB MSG LENGTH, THIS IS A MESSAGE 
MSG LENGTH EQU S-MSG-1 ;message length 



Symbol Names 

A symbol name must begin with a letter or a special character (either ? or _), 
followed by letters, special characters, or digits. 

You can use up to 255 characters in a symbol name, but only the first 31 characters 
are significant. A symbol name may contain upper- or lower-case characters, but the 
assembler converts to upper-case characters for internal representation. So, to ASM51, 
"buffer" is the same as "BUFFER" and the name 

"_A_THIRTY_ONE CHARACTER STRING_" 
is the same as the name 

" A THIRTY_ONE_CHARACTER STRING PLUS THIS." 

although the strings are different. 

The instruction mnemonics, assembly-time operators, predefined bit and data 
addresses, segment attributes, and assembler directives may not be used as user- 
defined symbol names. For a complete list of these reserved words, refer to 
Appendix F. 



Statement Labels 

A label is a symbol. All of the rules for forming symbol names apply to labels. A 
statement label is the first field in a line, but it may be preceded by any number of 
tabs or spaces. You must place a colon (:) after a label to identify it as a label. Only 
one label is permitted per line. 
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Labels are allowed only before empty statements, machine instructions, data initial- 
ization directives (DB and DW), and storage reservation directives (DS and DBIT). 
Simple names (without colons) can only precede symbol definition directives (EQU, 
SET, CODE, DATA, IDATA, XDATA, BIT, and SEGMENT). All other 
statements may not be preceded by labels or simple names. 

When a label is defined, it receives a numeric value and segment type. The numeric 
value will always be the current value of the location counter of the currently 
selected segment at the point of use. The value of the label will be relocatable or 
absolute depending on the relocatability of the current segment. The segment type 
will be equivalent to the segment type of the current segment. 

Several examples of lines containing labels are shown below: 

LABEL1 : DS 1 

LABEL2: ;This line contains no instruction; it is an empty statement 

LAB3: DB 27,33. -FIVE 1 

MOV PROC: MOV DPTR,#LABEL3 

You can use labels like any other symbol, as a memory address, or a numeric value 
in an assembly-time expression. A label, once defined, may not be redefined. 



Symbol Definition 

The symbol definition directives allow you to create symbols that can be used to 
represent segments, registers, numbers, and addresses. None of these directives may 
be preceded by a label. 

Symbols defined by these directives may not have been previously defined and may 
not be redefined by any means. The SET directive is the only exception to this. 



SEGMENT Directive 

The format for the SEGMENT directive is shown below. Note that a label is not 
permitted. 

relocatable _ segment name SEGMENT segment type I relocation type/ 

The SEGMENT directive allows you to declare a relocatable segment, assign a set of 
attributes, and initialize the location counter to zero (0). 

Although the name of a relocatable segment must be unique in the module, you can 
define portions of the segment within other modules and let RL51 combine them. 
When you do this, the segment type attributes must all be the same and the reloca- 
tion types must either be the same or be of two types, one of which is UNIT (see 
below). In the latter case, the more restrictive type will override. 

The segment type specifies the address space where the segment will reside. The 
allowable segment types are: 

• CODE— the code space 

• XDATA — the external data space 

• DATA — the internal data space accessible by direct addressing (0 to 1 27) 

• IDATA— the entire internal data space accessible by indirect addressing (0 to 
127) 

• BIT— the bit space (overlapping locations 32 to 47 of the internal data space) 
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The relocation type, which is optional, defines the relocation possibilities to be assigned 
by the RL51. The allowable relocation types are: 

• PAGE— specifies a segment whose start address must be on a 256-byte page 
boundary. Allowed only with CODE and XDATA segment types. 

• INPAGE— specifies a segment which must be contained in a 256-byte page. 
Allowed only with CODE and XDATA segment types. 

• IN BLOCK — specifies a segment which must be contained in a 2048-byte block. 
Allowed only for CODE segments. 

• BITADDRESSABLE— specifies a segment which will be relocated by RL51 
within the bit space on a byte boundary. Allowed only for DATA segments; 
limited to a 16-byte maximum size. 

• UNIT — specifies a segment which will be aligned on a unit boundary. This will 
be a byte boundary for CODE, XDATA, DATA, and 1DATA segments and a 
bit boundary for BIT segments. This relocation type is the default value. 

NOTE 

When used in expressions, the segment symbol stands for the base 
address of the combined segment. 

Any DATA or IDATA segments may be used as a stack (there is no explicit stack 
segment). 

For example, 

STACK SEGMENT IDATA 

RSEG STACK 

DS 10H ;Reserve 16 bytes tor stack 

MOV SPJSTACK-1 initialize stack pointer 

EQU Directive 

The format for the EQU directive is shown below. Note that a label is not permitted. 
symbol name EQU expression 

or 

symbol . name EQU special assembler symbol 

The EQU directive assigns a numeric value or special assembler symbol to a 
specified symbol name. The symbol name must be a valid ASM51 symbol as 
described above. 

If you assign an expression to the symbol, it must be an absolute or simple 
relocatable expression with no forward references. You can use the symbol as a data 
address, code address, bit address, or external data address depending on the seg- 
ment type of the expression, i.e., the symbol will have the segment type of the 
expression. If the expression evaluates into NUMBER, the symbol will be con- 
sidered as such and will be allowed to be used everywhere. 

The special assembler symbols A, RO, Rl, R2, R3, R4, R5, R6, and R7 can be 
represented by user symbols defined with the EQU directive. If you define a symbol 
to a register value, it will have a type "REG". It can only be used in the place of that 
register in instruction operands. 



Assembler Directives 4-5 



A symbol defined by the EQU directive cannot be defined anywhere else. 
The following examples show several uses of EQU : 

ACCUM EQU A ; define ACCUM to stand for A 

; (the 8051 accumulator) 
N27 EQU 27 ; set N27 to equal 27 

HERE EQU $ ; set HERE to current location counter 

; value 

DADDR1 EQU DADDR0 + 1 ; Assuming DADDRO is a DATA address 
; DADDR1 will also be a DATA address 

SET Directive 

The format for the SET directive is shown below. 
symbol name SET expression 

or 

symbol name SET special assembler _ symbol 

The SET directive operates similiar to EQU. The difference is that the defined sym- 
bol can be redefined later, using another SET directive. 

NOTE 

You cannot set a symbol which was equated and you cannot equate a sym- 
bol which was set. 

The following examples show several uses of SET: 

COUNT SET initialize absolute counter 

COUNT SET COUNT + 1 increment absolute counter 
HALF SET WHOLE/2 ;Give half of WHOLE to HALF 

;the remainder is discarded 
H20 SET 32 ;SetH20to32 

INDIRECT SET R1 ;Set INDIRECT to R1 

BIT Directive 

The format for the BIT directive is shown below. 

symbol name BIT bit_address 

The BIT directive assigns a bit address to the specified symbol name. 

Bit address format is described in Chapter 2. The symbol gets the segment type BIT. 
A symbol defined as BIT may not be redefined elsewhere in the program. 

The following examples show several uses of BIT: 

RSEG DATA. SEG ;A relocatable bit addressable segment 
CONTROL: DS 1 



ALARM BIT CONTROL. .Bit in a relocatable byte 

OPEN_DOOR BIT ALARM + 1 ;The next bit 
RESET_. BOARD BIT 060H ;An absolute bit 
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DATA Directive 

The format for the DATA directive is shown below. 

symbols name DATA expression 

The DATA directive assigns an on-chip data address to the specified symbol name. 
The expression must be an absolute or simple relocatable expression. Absolute 
expressions greater than 127 must specify a defined hardware register (see Chapter 
l). The segment type of the expression must be either DATA or NUMBER. The 
symbol gets the segment type DATA. 

A symbol defined by the DATA directive may not be redefined elsewhere in the 



The following examples show several uses of DATA: 



CONIN 



DATA SBUF 



TABLE _ BASE DATA 



TABLE END DATA 



70 H 



REL TABLE DATA REL START + 1 



;define CONIN to address 

;the serial port buffer 

;define TABLE BASE to be 

:at location 70H 

idefine TABLE END to be 

;attop of RAM (7FH) 

; Define REL TABLE to be a 

relocatable symbol (assuming 

.REL START is) 



XDATA Directive 

The format for the XDATA directive is shown below. 

symbol name XDATA expression 

The XDATA directive assigns an off-chip data address to the specified symbol 
name. The expression must be an absolute or simple relocatable expression. If the 
expression does not evaluate to a number, its segment type must be XDATA. The 
symbol gets the segment type XDATA. A symbol defined by the XDATA directive 
may not be redefined elsewhere in the program. 

The following examples show several uses of XDATA: 



DATE: 

TIME 

PLACE 



RSEG XSEG1 
ORG 100H 
DS 5 
XDATA DATE +5 
XDATA TIME + 3 



;Define DATE to 100H off XSEG1 base 
:define TIME to be 5 bytes after DATE 
;define PLACE to be 3 bytes after TIME 



IDATA Directive 

The format for the [DATA directive is shown below. 

symbol_ name IDATA expression 

The IDATA directive assigns an indirect internal data address to the specified sym- 
bol name. The expression must be an absolute or simple relocatable expression. 
Absolute expressions may not be larger than 1 27 for the 805 1 . The segment type of 
the expression must be either IDATA or NUMBER. The symbol gets the segment 
type IDATA. A symbol defined by the IDATA directive may not be redefined 
elsewhere in the program. 
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The following examples show several uses of 1DATA: 

BUFFER IDATA 60H 

BUFFEFLLEN EQU 20H 

BUFFER, END IDATA BUFFER + BUFFER LEN-1 



CODE Directive 

The format for the CODE directive is shown below. 

symbol _name CODE expression 

The CODE directive assigns a code address to the specified symbol name. The 
expression must be an absolute or simple relocatable expression. If the expression 
does not evaluate to a number, its segment type must be CODE. The symbol gets a 
segment type of CODE. A symbol defined by the CODE directive may not be 
redefined elsewhere in the program. 

The following examples show several uses of the CODE directive: 

RESTART CODE 00H 

INT_VEC0 CODE 03H 

INT_VEC1 CODE OBH 

INT_VEC2 CODE 1 BH 



Storage Initialization and Reservation 

The storage initialization and reservation directives are used to initialize and reserve 
space in either word, byte, or bit units. The space reserved starts at the point indi- 
cated by the current value of the location counter in the currently active segment. 
These directives may be preceded by a label. 

DS Directive 

The format of the DS directive is as follows: 
[label:] DS expression 

The DS directive reserves space in byte units. It can be used in any segment except a 
BIT type segment. The expression must be a valid assembly-time expression with no 
forward references and no relocatable or external references. When a DS statement 
is encountered in a program, the location counter of the current segment is incre- 
mented by the value of the expression. The sum of the location counter and the 
specified expression should not exceed the limitations of the current address space, 
or those set by the current relocation type. 

DBIT Directive 

The format of the DBIT directive is as follows: 

[label:] DBIT expression 

The DBIT directive reserves a space in bit units. It can be used only in a BIT type 
segment. The expression must be a valid assembly-time expression with no forward 
references. When the DBIT statement is encountered in a program, the location 
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counter of the current (BIT) segment is incremented by the value of the expression. 
Note that in a BIT segment, the basic unit of the location counter is in bits rather 
than bytes. 

DB Directive 

The format for a DB directive is shown below: 

[label:] DB expression^ list 

The DB directive initializes code memory with byte values. Therefore, a CODE type 
segment must be active. The expression list is a series of one or more byte values or 
strings separated by commas!,). A byte value can be represented as an absolute or 
simple relocatable expression or as a character string. Each item in the list (expres- 
sion or character string) is placed in memory in the same order as it appears in the 
list. 

The DB directive permits character strings longer than 2 characters, but they must 
not be part of an expression (i.e., you cannot use long character strings with an 
operator, including parentheses). If you specify the null character string as an item 
in the list (not as part of an expression), it generates no data. If the directive has a 
label, the value of the label will be the address of the first byte in the list. 

The following examples show several ways you can specify the byte value list in a DB 
directive: 

AGE: DB MARY'. 0.27. 'BILL'. 0,25, 'JOE', 0.21. 'SUE .0.1 8 
: This DB statement lists the names (character strings) 
; and ages (numbers) that have been placed in a list (the label 
: AGE will address the "M" in "MARY") 

PRIMES: DB 1,2. 3. 5. 7. 11. 13. 17.19. 23. 29. 31, 37,41, 43,47. 53 
: This DB lists the first 17 prime numbers. 
: (PRIMES is the address of 1) 

QUOTE: DB 'THIS IS A QUOTE" ' ; This is an example of how to put the 

; quote character in a character 
: string. 



DW Directive 

The format for a DW statement is shown below: 

[label: ] DW expression list 

The DW directive initializes code memory with a list of word (16-bit) values. 
Therefore, a CODE type segment must be active. The expression list can be a series 
of one or more word values separated by commas!,). Word values can be absolute or 
simple relocatable expressions. If you use the location counter (S) in the list, it 
evaluates to the code address of the word being initialized. Unlike the DB directive, 
no more than two characters are permitted in a character string, and the null 
character string evaluates to 0. 

Each item in the list is placed in memory in the same order as it appears in the list, 
with the high order byte first, followed by the low order byte (unlike the way it is 
handled by the ASM80/86). If the statement has a label, the value of the label will 
address the first value in the list (i.e., the high order byte of the first word). 
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The following examples show several ways you can specify the word value lis! in a 
DW directive: 

ARRIVALS: DW 71 0,' AM', 943, 1 AM', 315,'PM',941 'PM ' 
; This DW lists several flight arrivals. 
; The numbers and characters are encoded 
: consecutively. 

INVENTORY: DW 'F', 27869, 'G', 34524, 'X'. 27834 

: This list of characters and numeric 
; values will be encoded with the high 
; order byte of each character string 
; filled with zeros. INVENTORY will 
; address a zero byte. 

JUMP^TABLE DW GO_PROC. BREAK PROC, DISPLAY PROC 

; A jump table is constructed by listing 

; the procedure addresses 
DW $. $-2, $-4. $-6 ; This DW statement initializes four 

: words of memory with the same value. 

: (The location counter is incremented 

; by 2 for each item in the list. I 



Program Linkage 

Program linkage directives allow the separately assembled modules to communicate 
by permitting intermodule references and the naming of modules. 

PUBLIC Directive 

The format for the PUBLIC directive is shown below: 

PUBLIC list of names 

The PUBLIC directive allows symbols to be known outside the currently assembled 
module. If more than one name is declared public, the names must be separated by 
commas (,). Each symbol name may be declared public only once in a module. Any 
symbol declared PUBLIC must have been defined somewhere else in the program. 
Predefined symbols and symbols defined as registers or segments (declared via the 
SEGMENT directive) may not be specified as PUBLIC. 

The following examples show several uses of the PUBLIC directive: 

PUBLIC put crlf, put_string, put._ data str 
PUBLIC ascbin, binasc 
PUBLIC liner 



EXTRN Directive 

The format for the EXTRN directive is shown below: 

EXTRN [segment_type (list_ot_symbol __names)}, ... 

The EXTRN directive lists symbols to be referenced in the current module that are 
defined in other modules. This directive may appear anywhere in the program. 
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The list of external symbols must have a segment type associated with each symbol 
on the list. (The segment types are CODE, XDATA, DATA, IDATA, BIT, and 
NUMBER, i.e., a typeless symbol.) The segment type indicates the way a symbol 
may be used (e.g., a CODE type external symbol may be used as a target to a jump 
instruction but not as the target of a move instruction). At link and locate time, the 
segment type of the corresponding public symbol must match the segment type of 
the EXTRN directive. This match is accomplished if either type is NUMBER or if 
both types are the same. 

The following examples show several uses of the EXTRN directive: 

EXTRN CODE (put crlf, put . string, get_num), DATA (count.total) 

EXTRN CODE (binasc, ascbin), NUMBER (table size) 



NAME Directive 

The format for the NAME directive is shown below: 
NAME module ^name 

The NAME directive is used to identify the current program module. All the rules 
for naming apply to the module name. The NAME directive should be placed before 
all directives and machine instructions in the module. Only comments and control 
lines can precede the NAME directive. 

If you choose not to use the name directive, the root (i.e., the file name without both 
the drive and the extension identifiers) of the source filename is used as the default. 

NOTE 

When filename roots start with a digit and the NAME directive is not 
specified, the module name cannot be used in the RL51 module list (such a 
module name is illegal for RL51). 

The symbol used in the NAME directive is considered undefined for the rest of the 
program unless it is specifically defined later. 

The following examples show several uses of the NAME directive: 

NAME track 
NAME compass 
NAMEchapter_45 



Assembler State Controls 



END Directive 

Every program must have an END statement. Its format is shown below: 
END 

The END statement must not have a label, and only a comment may appear on the 
line with it. The END statement should be the last line in the program; otherwise, 
this will produce an error. 



I 
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ORG Directive 

The ORG directive is used to alter the assembler's location counter to set a new pro- 
gram origin for statements that follow the directive. 

The format for the ORG directive is shown below. Note that a label is not permitted. 
ORG expression 

The expression should be an absolute or simple relocatable expression referencing 
the current segment and containing no forward references. 

When the ORG directive is encountered in a program, the value of the expression is 
computed as the new value of the location counter specifying the address at which 
the next machine instruction or data item will be assembled in the current selected 
segment. If the current segment is absolute, the value will be an absolute address in 
the current segment; if the segment is relocatable, the value will be offset from the 
base address of the instance of the segment in the current module. 

The ORG directive modifies the location counter; it does not generate a new seg- 
ment. That is, when the location counter is incremented from the current value, the 
space between the previous and the current location counter becomes part of the cur- 
rent segment. 

In an absolute segment, the location counter must not be decremented to an address 
below the beginning of that segment. 

Examples: 

ORG ($ + 10H)AND OFFFOH : set location counter to next 

, 16-byte boundary 
ORG 50 ; set location counter to 50 



Segment Selection Directives 

The segment selection directives will divert the succeeding code or data into the 
selected segment until another segment is selected by a segment selection directive. 
The directives may select a previously defined relocatable segment, or optionally 
create and select absolute segments. 

The format for relocatable segment selection directives is shown below. Note that a 
label is not permitted and that the name must be previously defined as a segment 
name. 

RSEG segment name 

The format for absolute segment select directives is shown below. Note that a label is 
not permitted here either. 

CSEg"! 
XSEG I 

DSEG > [AT absolute address] 



CSEG, DSEG, ISEG, BSEG, and XSEG select an absolute segment within the code, 
internal data, indirect internal data, bit, or external data address spaces, respec- 
tively. If you choose to specify an absolute address (by including "AT absolute 
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address"), the assembler terminates the last absolute segment, if any, of the 
specified segment type, and creates a new absolute segment starling at that address . 
If you do not specify an absolute address, the last absolute segment of the specified 
type is continued. If no absolute segment of this type was selected and the absolute 
address is omitted, a new segment is created starting at location 0. You cannot use 
any forward references and the start address must be an absolute expression. 

Each segment has its own location counter; this location counter is always set to in 
the initial state. The default segment is an absolute code segment; therefore, the 
initial state of the assembler is location in the absolute code segment. When 
another segment is chosen for the first time, the location counter of the former seg- 
ment retains the last active value. When that former segment is reselected, the loca- 
tion counter picks up at the last active value. You can use the ORG directive to 
change the location counter within the currently selected segment. 



DATA_SEG1 


SEGMENT DATA 


; A relocatable data segment 


CODE SEG1 


SEGMENT CODE 


: A relocatable code segment 




BSEG AT70H 


; Absolute bit segment 


DECIMAL MODE 


DBIT 1 


; Absolute bit 


CHAR MODE: 


OBIT 1 






RSEG DATA 


SEG1 : Select the relocatable data segment 


TOTAL1: 


DS 1 




COUNT1: 


DS 1 




COUNT W: 


DS 2 






RSEG CODE 


SEG1 ; Select the relocatable code segment 


BEGIN CODE: 







USING Directive 

The format for the USING directive is shown below. Note that a label is not 
permitted. 

USING expression 

This directive notifies the assembler of the register bank that is used by the subse- 
quent code. The expression is the number (between and 3 inclusive) which refers to 
one of four register banks. 

The USING directive allows you to use the predefined symbolic register addresses 
(ARO through AR7) instead of their absolute addresses. In addition, the directive 
causes the assembler to reserve a space for the specified register bank. 

Examples: 

USING 3 

PUSH AR2 ;Push register 2 of bank 3 

USING 1 

PUSH AR2 ;Push register 2 of bank 1 

Note that if you equate a symbol (e.g., using EQU directive) to an ARi symbol, the 
user-defined symbol will not change its value as a result of the subsequent USING 
directive. 



The Macro Processing Language 




Introduction 

The Macro Processing Language (MPL) of ASM51 is a string replacement facility. 
It permits you to write repeatedly used sections of code once and then insert that 
code at several places in your program. If several programmers are working on the 
same project, a library of macros can be developed and shared by the entire team. 
Perhaps MPL's most valuable capability is conditional assembly— with all 
microprocessors, compact configuration dependent code is very important to good 
program design. Conditional assembly of sections of code can help to achieve the 
most compact code possible. 

This chapter documents MPL in three parts. The first section describes how to 
define and use your own macros. The second section defines the syntax and 
describes the operation of the macro processor's built-in functions. The final section 
of the chapter is devoted to advanced concepts in MPL. 

The first two sections give enough information to begin using the macro processor. 
However, sometimes a more exact understanding of MPL's operation is needed. 
The advanced concepts section should fill those needs. 

Don't hesitate to experiment. MPL is one of the most powerful and easy to use tools 
available to programmers. 



Macro Processor Overview 

The macro processor views the source file in very different terms than the assembler. 
Figure 5-1 illustrates these two different views of the input file. To the assembler, the 
source file is a series of lines— control lines, instruction lines, and directive lines. To 
the macro processor, the source file is a long string of characters. 

The figure below shows these two views of the source file. 




Figure 5-1. Macro Processor versus Assembler— Two Different Views of a Source File 
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All macro processing of the source file is performed before your code is assembled. 
Because of this independent processing of macros and assembly of code, we must 
differentiate between macro-time and assembly-time. At macro-time, assembly- 
language symbols— labels, SET and EQU symbols, and the location counter are not 
known. Similarly, at assembly-time, no information about macros is known. 

The macro processor scans the source file looking for macro calls. A macro call is a 
request to the processor to replace the call pattern of a built-in or user-defined 
macro with its return value. 

When a macro call is encountered, the macro processor expands the call to its return 
value. The return value of a macro is then placed in a temporary workfile, and the 
macro processor continues. All characters that are not part of a macro call are 
copied into the temporary workfile. 

The return value of a macro is the text that replaces the macro call. The return value 
of some macros is the null string. (The null string is a character string containing no 
characters.) In other words, when these macros are called, the call is removed from 
the input stream, and the assembler never sees any evidence of its presence. This is 
particularly useful for conditional assembly. 



Introduction to Creating and Calling Macros 

The macro processor is a character string replacement facility. It searches the source 
file for a macro call, and then replaces the call with the macro's return value. A % 
signals a macro call. % is the default metacharacter. The metacharacter must 
precede a macro call. Until the macro processor finds a metacharacter, it does not 
process text. It simply passes the text from the source file to a workfile, which is 
eventually assembled. 

Since MPL only processes macro calls, it is necessary to call a macro in order 10 
create other macros. The built-in function DEFINE creates macros. Built-in func- 
tions are a predefined part of the macro language, so they may be called without 
prior definition. The general syntax for DEFINE is: 

%[']DEF\NE[call-pattern)\local-symbol-listHmacro-body) 

DEFINE is the most important MPL built-in function. This section of the chapter is 
devoted to describing this built-in function. Each of the symbols in the syntax above 
(call-pattern, local-symbol-list, and macro-body) are thoroughly described in the 
pages that follow. In some cases we have abbreviated this general syntax to 
emphasize certain concepts. 

Creating Simple Macros 

When you create a simple macro, there are two parts to a DEFINE call: the call pat- 
tern and the macro body. The call pattern defines the name used when the macro is 
called; the macro body defines the return value of the call. 

The syntax of a simple macro definition is shown below: 

%'DEFINE {call-pattern) (macro-body) 

The is the metacharacter that signals a macro call. The '*' is the literal 
character. The literal character is normally used when defining macros. The exact 
use of the literal character is discussed in the advanced concepts section of this 
chapter. 
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When you define a simple macro, the call-pattern is a macro identifier. It follows the 
metacharacter, when you call the macro in the source file. The rules for macro iden- 
tifiers are the same as ASM5 1 symbol names. 

• The identifier must begin with an alphabetic character (A,B,C Z or 

a,b,c z) or a special character (a question mark ? or an underscore 

character( )). 

• The remaining characters may be alphabetic, special, or decimal digits 
(0,1,2 9). 

• Only the first 31 characters of a macro identifier are recognized as the unique 
identifier name. Upper and lower case characters are not distinguished in a 
macro identifier. 

The macro-body is usually the return value of the macro call. However, the macro- 
body may contain calls to other macros. If so, the return value is actually the fully 
expanded macro body, including the calls to other macros. When you define a 
macro using the syntax shown above, macro calls contained in the body of the 
macro are not expanded, until you call the macro. 

The syntax of DEFINE requires that left and right parentheses surround the macro- 
body. For this reason, you must have balanced parentheses within the macro body 
(i.e., each left parenthesis must have a succeeding right parenthesis, and each right 
parenthesis must have a preceding left parenthesis). We call character strings that 
meet these requirements balanced-text. 

To call a macro, you use the metacharacter followed by the call-pattern for the 
macro. (The literal character is not needed when you call a user-defined macro.) The 
macro processor will remove the call and insert the return value of the call. If the 
macro body contains any call to other macros, they will be replaced with their return 
value. 

Once a macro has been created, it may be redefined by a second call to DEFINE. 

The three examples below show several macro definitions. Their return values are 
also shown. 



Example 1 : 

Macro definition at the top of program: 
%-DEFINE(MOVE)( 

MOV A.@R1 
MOV <S RO.A 
INCR1 
INCRO 

) 

Macro call as it appears in program (* literal character is not needed when you call 
the user-defined macro): 

POPACC 
MOV R1,A 
POPACC 
MOVRO.A 
%MOVE 
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The program after the macro processor makes the expansion: 

POP ACC 
MOV R1.A 
POP ACC 
MOV RO.A 



Example 2: 

Macro definition at the top of the program: 
%"DEFINE (MULT) ( 



The macro call as it appears in original program body: 

MOV B,@R1 
MOV A,S RO 
%MULT 
MOV (fi RO.A 

The program after macro expansion: 

MOV B,@R1 

MOV A. a RO . 



LCALLOVFL ERR 
MOV@R0,A 



Example 3: 

Here is a macro that calls MULT to multiply 5 bytes: 

%*DEFINE(MULT 5)( 
MOV R7,#5 
MOV R0,#ADDR1 
MOV R1,#ADDR2 
TOP: MOVB,@R1 
MOV A.pRO 
%MULT 
MOV (5 RO.A 
INC RO 
INC R1 

DJNZ R7.TOP 



MOV A,® R1 
MOV @R0,A 
INCR1 
INCRO 



this is the return value 



MUL AB 
JNBOV,($ + 6) 
LCALL OVFI — ERR 
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This macro when called inserts the following code: 

MOV R7,#5 
MOV R0,#ADDR1 
MOV R1,#ADDR2 
TOP: MOVB,@R1 
MOV A,@R0 

MUL AB 

JNBOV,($ + 6) 

LCALL OVFL ERR 
MOV % RO.A 
INC RO 
INCR1 

DJNZ R7.TOP 

Macros with Parameters 

If the only thing the macro processor could do was simple string replacement, then it 
would not be very useful for most programming tasks. Each time we wanted to 
change even the simplest part of the macro's return value, we would have to redefine 
the macro. Parameters in macro calls allow more general purpose macros. 

Parameters leave blanks or holes in a macro body that you will fill in when you call 
the macro. This permits you to design a single macro that produces code for many 
typical programming operations. 

The term parameter refers to both the formal parameters that are specified when the 
macro is defined (the blanks), and the actual parameters or arguments that are 
specified when the macro is called (the fill-ins). 

The syntax for defining macros w ith parameters is very similar to the syntax for sim- 
ple macros. The call-pattern that we described earlier actually includes both the 
macro-name and an optional parameter-list . With this addition, the syntax for 
defining simple macros becomes: 

%*DEF\NE(macro-name\parameter-list\) (macro-body) 

The '%*DEFINE' is required for the same reasons described earlier. 

The macro-name must be a valid macro identifier. 

The parameter-list is a list of macro identifiers separated by macro delimiters. This 
comprises the formal parameters used in the macro. The macro identifier for each 
parameter in the list must be unique. 

Typically, the macro delimiters are parentheses and commas. When using these 
delimiters, you would enclose the parameter list in parentheses and separate each 
formal parameter with a comma. When you define a macro using parentheses and 
commas as delimiters, you must use those same delimiters, when you call that 
macro. The Advanced Concepts section completely describes the use of macro 
delimiters. For now we will use parentheses and commas when defining macros. 

The macro-body must be a balanced-text string. To indicate the locations of 
parameter replacement (the holes to be filled in by the actual parameters), place the 
parameter's name preceded by the metacharacter in the macro body. The 
parameters may be used any number of times and in any order within the macro 
body. If a user-defined macro has the same macro identifier name as one of the 
parameters to the macro, the macro may not be called within the macro body, 
because the parameter takes precedence. 



this is the return 
value of MULT 



this is the return 
f value of MULT 5 
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The example below shows the definition of a macro with three dummy parameters— 
SOURCE, DESTINATION, and COUNT. The macro will produce code to copy 
any number of bytes from one part of memory to another. 

%*DEFINE(MOVE_BYTES(SOURCE, DESTINATION. COUNT)) ( 
MOV R7,#%COUNT 
MOV R1,#%SOURCE 
MOV R0,#%DESTINATION 
MOV A,@R1 
MOV @ RO.A 
INCR1 
INCRO 

DJNZR7,($-4) 
) 

To call the above macro, you must use the metacharacter followed by the macro's 
name similar to simple macros without parameters. However, a list of the actual 
parameters must follow. The actual parameters must be surrounded by parentheses, 
and separated from each other by commas, as specified in the macro definition. The 
actual parameters must be balanced-text and may optionally contain calls to other 
macros. A simple call to the macro defined above might be: 

%MOVE BYTES(8,16,8) 

The above macro call produces the following code: 

MOV R7,#8 
MOV R1,#8 
MOV R0.»16 
MOVA.S, R1 
MOV r„ RO.A 
INCR1 
INCRO 

DJNZ R7.($-4) 

The code above will copy the contents of register bank 2 to register bank 3. (We 
hope the user knows which bank is active when he executes this code.) 



LOCAL Symbols List 

The DJNZ instruction above uses offset addressing ($-4). If we chose to use a label 
for the jump destination, the macro could only be used once, since a second macro 
call would cause a conflict in label definitions. We could make the label a parameter 
and specify a different ASM51 symbol name each time we call the macro. The best 
way is to put the label in a LOCAL list. The LOCAL list construct allows you to use 
macro identifiers to specify assembly-time symbols. Each use of a LOCAL symbol 
in a macro guarantees that the symbol will be replaced by a unique assembly-time 
symbol. 

The macro processor increments a counter each time your program calls a macro 
that uses the LOCAL construct. The counter is incremented once for each symbol in 
the LOCAL list. Symbols in the LOCAL list, when used in the macro body, receive a 
two to five digit suffix that is the hexadecimal value of the counter. The first time 
you call a macro that uses the LOCAL construct, the suffix is '00'. 
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The syntax for the LOCAL construct in the DEFINE functions is shown below (This 
is the complete syntax for the built-in function DEFINE): 

% ' DE Fl N E{macro-name \parameter-list]) | LOCAL local-list ] {macro-body ) 

The local-list is a list of valid macro identifiers separated by spaces. The LOCAL 
construct in a macro has no affect on the syntax of a macro call. 

The example below shows the MOVE BYTES macro definition that uses a 

LOCAL list: 

%*OEFINE(MOVE BYTESISOURCE, DESTINATION. COUNT)) LOCAL LABEL 
(MOV R7,#%COUNT 
MOV R1.#%SOURCE 
MOV R0.#7„DESTINATION 
%LABEL: MOVA,@R1 
MOV@R0,A 
INC R1 
INCRO 

DJNZ R7.%LABEL 

) 

The following macro call: 

%MOVE BYTES(67,100.20) 

might produce this code (if this is the eleventh call to a macro using a LOCAL list): 

MOV R7,#27 
MOV R1,#67 
MOV R0.#100 
LABELOA: MOV A.«i R1 
MOV0RO.A 
INCR1 
INCRO 

DJNZ R7. LABELOA 

NOTE 

Since macro identifiers follow the same rules as ASM51, you can use any 
macro identifier in a LOCAL list. However, if you use long identifier names 
(31 characters or more), the appended call number will be lost when the 
assembler truncates the excess characters. 



The Macro Processor's Built-in Functions 

The macro processor has several built-in or predefined macro functions. These built- 
in functions perform many useful operations that would be difficult or impossible to 
produce in a user-defined macro. An important difference between a user-defined 
macro and a built-in function is that user-defined macros may be redefined, while 
built-in functions cannot be redefined. 

We have already seen one of these built-in functions, DEFINE. DEFINE creates 
user-defined macros. DEFINE does this by adding an entry in the macro processor's 
table of macro definitions. Each entry in the table includes the call-pattern for a 
macro, and its macro body. Entries for the built-in functions are present when the 
macro processor begins operation. 
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Other built-in functions perform numerical and logical expression evaluation, affect 
control flow of the macro processor, manipulate character strings, and perform 
console I/O. 



Comment, Escape, Bracket, and METACHAR Built-in Functions 

Comment Function 

The Macro Processing Language can be very subtle, and the operation of macros 
written in a straightforward manner may not be immediately obvious. Therefore, it 
is often necessary to comment your macro definitions. Besides, it's just good 
programming practice. 

The macro processor's comment function has the following syntax: 
%-texf 
or 

%'text end-of-line 

The comment function always evaluates to the null string. Two terminating 
characters are recognized, the apostrophe and the end-of-line (line feed character, 
ASCII OAH). The second form of the call allows you to spread macro definitions 
over several lines, while avoiding any unwanted end-of-line^ in the return value. In 
either form of the comment function, the text or comment is not evaluated for 
macro calls. 

The example below shows a commented macro definition: 

%-DEFINE(MOVE BYTEStSOURCE. DESTINATION. COUNT)) LOCAL LABEL 

( 

MOV R7,#%COUNT %' iteration argument %COUNT ' 
MOV R1 .#%SOURCE %' source address argument %SOURCE 
MOV R0,#%DESTINATION %' destination address argument' 
%LABEL%' % LABEL is a local symbol that will be appended with a unique number 
MOVA,@R1 

MOV r a RO A 
INC R1 
INCRO 

DJNZ R7.%LABEL %'This is the same local symbol and 
%■ receives the same unique ID 

) 

Call to above macro: 

%MOVE BYTES127H.37H.5) 
Return value from above call: 
MOV R7,#5 

MOVR1,#27H MOVR0,#37H 
LABEL07: MOVA,@R1 
MOV <« RO.A 
INCR1 
INCRO 

DJNZ R7.LABEL07 
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Notice that the comments that were terminated with end-of-line removed the end-of- 
line character along with the rest of the comment. Because of this, the second line 
has two instuctions on it. That line will produce an error when assembled. However, 
when the comment was removed from the line containing the label °7oLABEL, the 
colon was raised to the same line making it a legal instruction. 

Note that the metacharacter is not recognized as a call to the macro processor when 
it appears in the comment function. 

Escape Function 

Occasionally, it is necessary to prevent the macro processor from processing text. 
There are two built-in functions that perform this operation: the escape function 
and the bracket function. 

The escape function interrupts the processor from its normal scanning of text. The 
syntax for this function is shown below: 

%n text-n-characters-long 

The metacharacter followed by a single decimal digit designates that the specified 
number of characters (maximum is 9) shall not be evaluated. The escape function is 
useful for inserting a metacharacter as text, adding a comma as part of an argument, 
or placing a single parenthesis in a character string that requires balanced 
parentheses. 

Several examples of the escape function are shown below: 

Before Macro Expansion After Macro Expansion 

; COMPUTE 10%1% OF SUM - ; COMPUTE 10% OF SUM 

%MACCALL(JANUARY23%1.1980, - JANUARY 23, 1980 



Bracket Function 

The other built-in function that inhibits the macro processor from expanding text is 
the bracket function. The syntax of the bracket function is shown below: 

%(balanced-text) 

The bracket function inhibits all macro processor expansion of the text contained 
within the parentheses. However, the escape function, the comment function, and 
parameter substitution are still recognized. Since there is no restriction for the length 
of the text within the bracket function, it is usually easier to use than the escape 
function. However, since balanced text is required and the metacharacter is inter- 
preted, often this is not sufficient, and the escape function must be used. 

Consider the following example of the bracket function. 

%*DEFINE(DW(LlST.LBL)) ( 
%LBL: DW %UST 

) 



MARCH 15%1, 1980, 
APRIL 9%1, 1980) 



MARCH 15. 1980 
APRIL9.1980 
actual parameters 



%MACCALL(1%1) ADD INPUTS. 

2%1 ) DIVIDE BY INPUT COUNT, 
3%1) GET INPUTS) 



1) ADD INPUTS 

2) DIVIDE BY INPUT COUNT 

3) GET INPUTS 
actual parameters 
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The macro above will add DW statements to the source file. It uses two parameters: 
one for the statement label and one for the DW expression list. Without the bracket 
function we would not be able to use more than one expression in the list, since the 
first comma would be interpreted as the delimiter separating the macro parameters. 
Bracket function permits more than one expression in the LIST argument: 

%DW(%(198H, 3DBH. 163BH), PHONE) - PHONE: DW 198H, 3DBH. 163BH 

In the example above, the bracket function prevents the character string M98H, 
3DBH, 163BH' from being evaluated as separate parameters. 

METACHAR Function 

The built-in function METACHAR allows you to redefine the metacharacter (%). 
Its syntax is shown below: 

% METACHAR {balanced-text) 

The balanced-text argument may be any number of characters long. However, only 
the first character in the string is taken to be the new metacharacter. Extreme cau- 
tion should be taken when using METACHAR, since it can have catastrophic 
effects. Consider the example below: 

%METACHAR( & ) 

In this example, METACHAR defines the space character to be the new meta- 
character, since it is the first character in the balanced-text string! 



Numbers and Expressions in MPL 

Many of the built-in functions recognize and evaluate numerical expressions in their 
arguments. The macros use the same rules for representing numbers as ASM5 1 : 

• Numbers may be represented in base 2 (B suffix), base 8 (O or Q suffix), base 10 
(D suffix or no suffix), and base 16 (H suffix). 

• Internal representation of numbers is 16 bits (00H to OFFFFH). 

• All ASM51 operators are recognized, except the symbolic forms of the 
relational operators (i.e., <, >, =, <>, >=, <=). The operators recognized by 
the macro processor and their precedence is shown in the list below : 

1. o 

2. HIGH, LOW 

3. •, /. MOD. SHL, SHR 

4 . + , - unary and binary forms 

5. EQ, NE.LE. LT. GE. GT 

6. NOT 

7. AND 

8. OR.XOR 

Although assembly-time and macro-time expressions use the same operators, the 
macro processor cannot access the assembler's symbol table. The values of labels 
and SET and EQU symbols are not known during macro-time expression evalua- 
tion. Any attempt to use assembly-time symbols in a macro-time expression 
generates an error. However, you can define macro-time symbols with the pre- 
defined macro SET. 
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SET Macro 

The SET predefined macro permits you to define macro-time symbols to values. 
SET takes two arguments: a valid MPL identifier, and a macro-time numeric 
expression. 

SET has the following syntax: 

%SEX [macro-id , expression) 

SET assigns the value of the numeric expression to the identifier, macro-id. 
macro-id must follow the same syntax conventions used for macro identifiers. 

• The first character must be a letter of the alphabet or a question mark or an 
underscore. 

• The remaining characters may be digits, letters, question marks, or underscores. 

• Only the first 31 characters are recognized as the identifier name. Upper and 
lower case letters are not distinguished. 

The SET macro call affects the macro-time symbol table only; when it is 
encountered in the source file, the macro processor replaces it with the. null string. 
Symbols defined by SET can be redefined by a second SET call, or defined as a 
macro by a DEFINE call. 

The following examples show several ways to use SET: 

Before Macro Expansion After Macro Expansion 

%SET(COUNT.O) - nullstring 

%SET(OFFSET,16) - nullstring 

MOV R1,#%COUNT + %OFFSET - MOV R1 ,#00H + 10H 

MOV R4,#%COUNT - MOVR4,#00H 

The SET symbol may be used in the expression that defines its own value. 

%SET(COUNT,%COUNT + %OFFSET) - nullstring 

%SET(OFFSET,%OFFSET • 2) - nullstring 

MOV R2,#%COUNT + %OFFSET - MOV R2,#10H + 20H 

MOVR5,#%COUNT - MOVR5J10H 

In the example above, macro-time symbols are used rather than assembly-time 
symbols because their value is shown wherever they are used. With assembly-time 
symbols, you must look in the symbol table for its value. 

SET is a predefined macro, not a built-in function; as such it may be redefined, but 
we don't advise it. 



EVAL Function 

The built-in function EVAL accepts an expression as its argument and returns the 
expression's value in hexadecimal. The syntax for EVAL is: 

%EVAL(express/on ) 

The expression argument must be a legal macro-time expression. 
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The return-value from EVAL follows ASM51's rules for representing hexadecimal 
numbers (it has an 'H' suffix and when the leading digit is 'A', 'B', 'C, 'D', 'E\ or 
'F', it is preceded by 0). EVAL always returns at least 3 characters even when the 
argument evaluates to a single digit. The following examples show the return-value 
from EVAL: 



Before Macro Expansion 

MOV A,#%EVAL(1 +1); move two to A. 

COUNT EQU %EVAL(33H + 15H + 0F00H) 

ADD A,#%EVAL(10H-((13 + 6) • 2) + 7) 

%SET(NUM1.44) 
%SET(NUM2,25H) 

ANL A,#%EVAL(%NUM1 LE7»NUM2) 



After Macro Expansion 

- MOV A, #02H; move two to A. 

- COUNT EQU 0F48H 

- ADD A,#0FF0BH 

- ANL A,#00H 



Logical Expressions and String Comparisons in MPL 

Several built-in functions return a logical value when they are called. Like relational 
operators that compare numbers and return true or false (OFFFFH or 00H), these 
built-in functions compare character strings. If the function evaluates to 'TRUE,' 
then it returns the character string 'OFFFFH' (this represents a ] 6-bit value contain- 
ing all ones). If the function evaluates to 'FALSE,' then it returns '00H' (this 
represents a 1 6-bit value containing all zeros). 

The built-in functions that return a logical value compare two balanced-text string 
arguments and return a logical value based on that comparison. The list of string 
comparison functions below shows the syntax and describes the type of comparison 
made for each. Both arguments to these functions may contain macro calls (the calls 
are expanded before the comparison is made). 



%EQS(arg1 ,arg2) True if both arguments are identical 

%NES(arg7 ,arg2) True if arguments are different in any way 

%LTS(arg1 ,arg2) True if first argument has a lower value than second argument 

°/eLES(arg1 ,arg2) True if first argument has a lower value than second argument or if 
both arguments are identical 

°/°GTS{arg1 ,arg2) True if first argument has a higher value than second argument 



True if first argument has a higher value than second argument, or 
if both arguments are identical 



Before these functions perform a comparison, both arguments are completely 
expanded. Then the ASCII value of the first character in the first string is compared 
to the ASCII value of the first character in the second string. If they differ, then the 
string with the higher ASCII value is greater. If the first characters are the same, 
then the process continues with the second character in each string, and so on. Two 
strings of equal length that contain the same characters in the same order are equal. 
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The examples below show several calls to these macros: 



Before Macro Expansion 

%EQS(ABC, ABC) 
%LTS(CBA,cba) 

%GTS(11H,16D) 

%GES(ABCDEFG,ABCDEFG ) 



After Macro Expansion 



00H the space after the comma is part 
false of the second argument 

OFFFFH the lower-case characters have a 
true higher ASCII value than upper- 
case 

■* 00H these macros compare strings not 
false numerical values ASCII '6' is 
greater ASCII 1' 

00H the space at the end of the second 
false argument makes the second 
argument greater than the first 

As with any other macro, the arguments to the string comparison macros can be 
other macros. 



%"DEFINE(DOG) (CAT) 
%*DEF1NE(M0USE) (%DOG) 
%EQS(%DOG,%MOUSE) 



OFFFFH 
true 



Control Flow Functions 

Some built-in functions accept logical expressions in their arguments. Logical 
expressions follow the same rules as numeric expressions. The difference is in how 
the macro interprets the 16-bit value that the expression represents. Once the expres- 
sion has been evaluated to a 16-bit value, MPL uses only the low-order bit to deter- 
mine whether the expression is TRUE or FALSE. If the low-order bit is a one (the 
16-bit numeric value is odd), the expression is TRUE. If the low-order bit is a zero 
(the 16-bit value is even), the expression is FALSE. 

Typically, you will use either the relational operators (EQ, NE, LE, LT, GT, or GE) 
or the string comparison functions (EQS, NES, LES, LTS, GTS, or GES) to specify 
a logical value. Since these operators and functions always evaluate to OFFFFH (all 
ones) or 00H (all zeros), you needn't worry about the single bit test. But remember, 
all numeric expressions are valid, and regardless of the value of the other 15 bits, 
only the least significant bit counts. 



IF Function 

The IF built-in function evaluates a logical expression, and based on that expression, 
expands or witholds its text arguments. The syntax for the IF macro is shown below: 

• %IF (expression) THEN (balanced-textl) [ELSE [balanced-text2)\ Fl 

IF first evaluates the expression, if the low order bit is one, then balanced-textl is 
expanded; if the low order bit is zero and the optional ELSE clause is included in the 
call, then balanced-text2 is expanded. If the low order bit is zero and the ELSE 
clause is not included, the IF call returns the null string. Fl must be included to ter- 
minate the call. 
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IF calls can be nested; when they are, the ELSE clause refers to the most recent IF 
call that is still open (not terminated by Fl). Fl terminates the most recent IF call 
that is still open. 



Several examples of IF calls are shown below: 

This is the simple form of the IF call with an ELSE clause. 

%IF (%EQS(ADD,%OPERATION)) THEN (ADD A,R1 ) ELSE (SUBB A.R1) Fl 
This is an example of several nested IF calls. 



open first IF %IF (%EQS(ADD,%OPERATION)) THEN (ADD A.R1 
open second IF (ELSE (%IF (%EQS(SUBTRACT.%OPERATION)) THEN (SUBB A. R1 
JELSE (MOV B.R1 

open third IF %IF (%EQS(MULTIPLY.%OPERATlON)) THEN (MUL AB 

)ELSE(DIV AB 
close third IF ) Fl 

close second IF ) Fl 

close first IF ) Fl 



WHILE Function 

The IF macro is useful for implementing one kind of conditional assembly- 
including or excluding lines of code in the source file. However, in many cases this is 
not enough. Often you may wish to perform macro operations until a certain condi- 
tion is met. The built-in function WHILE provides this facility. 

The syntax of the WHILE macro is shown below: 

%WHILE (expression) (balanced-text) 

WHILE first evaluates the expression. If the least significant bit is one, then the 
balanced-text is expanded; otherwise, it is not. Once the balanced-text has been 
expanded, the logical argument is retested and if the least significant bit is still one, 
then the balanced-text is again expanded. This continues until the logical argument 
proves false (the least significant bit is 0). 

Since the macro continues processing until expression is false, the balanced-text 
should modify the expression, or else WHILE may never terminate. 

A call to the built-in function EXIT will always terminate a WHILE macro. EXIT is 
described below. 

The following examples show two common uses of the WHILE macro: 



%SET(COUNTER,5) 
%WHILE(%COUNTER GT 0) 
(RR A 

%SET(COUNTER, "/.COUNTER -1) 

) 



%WHILE(%LOC -COUNTER LTOFFFFH) ( NOP 

%SET(LOC_COUNTER, %LOC._ COUNTER + 1 ) ) 



These examples use the SET macro and a macro-time symbol to count the iterations 
of the WHILE macro. 
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REPEAT Function 

MPL offers another built-in function that will perform the counting automatically. 
The built-in function REPEAT expands its balanced-text a specified number of 
times. The general form of the call to REPEAT is shown below: 

%REPEAT {expression) (balanced-text) 

Unlike the IF and WHILE macros, REPEAT uses the expression for a numerical 
value that specifies the number of times the balanced-text will be expanded. The 
expression is evaluated once when the macro is first called, then the specified 
number of iterations is performed. 

The examples below will perform the same text insertion as the WHILE examples 
above. 

% REPEAT (5) (RR A 
) 

"/.REPEAT (OFFFFH - %LOC COUNTER) (NOP 

) 



EXIT Function 

The EXIT built-in function terminates expansion of the most recently called 
REPEAT, WHILE or user-defined macro. It is most commonly used to avoid 
infinite loops (e.g., a WHILE expression that never becomes false, or a recursive 
user-defined macro that never terminates). It allows several exit points in the same 
macro. 

The syntax for EXIT is: 
%EXIT 

Several examples of how you might use the EXIT macro follow: 

This use of EXIT terminates a recursive macro when an odd number of bytes are 
being added. 

%*DEFINE (MEM. ADD MEM (SOURCE, DESTIN. BYTES)) 

( 

MOV A.%SOURCE 
ADDC A.%DESTIN 
MOV%DESTIN,A 

IF (% BYTES EQ 1) THEN (%EXIT) Fl 
MOV A.%SOURCE + 1 
ADDC A. %DESTIN + 1 
MOV%DESTIN + 1, A 
IF (%BYTES GT 2) THEN ( 

%MEM _ADD_ MEM(%SOURCE + 2,%DESTIN + 2.%BYTES-2))FI 

) 

This EXIT is a simple jump out of a recursive loop. 

%*DEFINE(UNTIL ( CONDITION, BODY)) 
( %BODY 

%IF ("/.CONDITION) THEN (%EXIT) 

ELSE ( %UNTIL(%CONDITION,%BODY)) Fl 

) 
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String Manipulation Built-in Functions 

The purpose of the Macro Processor is to manipulate character strings. Therefore, 
there are several built-in functions that perform common character string manipula- 
tion functions. 



LEN Function 

The built-in function LEN takes a character string argument and returns the length 
of the character string in hexadecimal (the same format as EVAL). The character 
string argument to LEN is limited to 256 characters. 

The syntax of the LEN macro call is shown below: 

%Li.H{balanced-text) 

Several examples of calls to LEN and the hexadecimal numbers returned are shown 
below: 



Before Macro Expansion After Macro Expansion 

%LEN(ABCDEFGHlJKLMNOPQRSTUVWXYZ) - 1 AH 

%LEN(A,B,C) — 05H commas are counted 

%LEN( ) - 00H 

%'DEFINE(CHEESE)(MOUSE) 
%'DEFINE(DOG)(CAT) 

%LEN(%DOG %CHEESE) - 09H 

A the space after G is counted 
as part of the length 



SUBSTR Function 

The built-in function SUBSTR returns a substring of its text argument. The macro 
takes three arguments: a character string to be divided and two numeric arguments. 
The syntax of the macro call to SUBSTR is shown below: 

%SUBSTRibalanced-text,expression1 ,expression2) 

balanced-text is described above. It may contain macro calls. 

expression! specifies the starting character of the substring. 

expression! specifies the number of characters to be included in the substring. 

If expression! is zero or greater than the length of the argument string, then 
SUBSTR returns the null string. 

If expression2 is zero, then SUBSTR returns the null string. If expression2 is greater 
than the remaining length of the string, then all characters from the start character 
to the end of the string are included. 
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The examples below show several calls to SUBSTR and the value returned: 
Before Macro Expansion After Macro Expansion 

%SUBSTR(ABCDEFG,8.1) - null 

%SUBSTR(ABCDEFG,3,0) - null 

%SUBSTR(ABCDEFG,5,1) - E 

%SUBSTR(ABCDEFG,5,100) - EFG 

%SUBSTR(123(56)890,4,4) - (56) 

MATCH Function 

The built-in function MATCH searches a character string for a delimiter character, 
and assigns the substrings on either side of the delimiter to the identifiers. The syn- 
tax of the MATCH call is shown below: 

%MATCH(tdentifierl delimiter identified) [balanced-text) 

identifierl and identifier! are valid MPL identifiers. 

delimiter is the first character to follow identifierl . Typically, a space or comma is 
used, but any character that is not a macro identifier character may be used. You 
can find a more complete description of delimiters in the Advanced Concepts section 
at the end of the chapter. 

balanced-text is as described earlier in the chapter. It may contain macro calls. 

MATCH searches the balanced-text string for the specified delimiter. When the 
delimiter character is found, then all characters to the left of it are assigned to iden- 
tifierl and all characters to the right are assigned to identifier!. If the delimiter is 
not found, the entire balanced-text string is assigned to identifierl and the null 
string is assigned to identifier! . 

The following example shows a typical use of the MATCH macro. 

%MATCH(N EXT, LIST} (10H, 20H, 30H) 
%WHILE(%LEN(%NEXT) NE 0) ( 

MOVA,%NEXT 

ADD A,#22H 

MOV%NEXT.A 

%MATCH(NEXT,LIST)(%LIST) 

) 

Produces the following code: 



first 


MOV A.10H 


iteration 


ADD A.#22H 


of WHILE J 


MOV10H.A 


second 


MOV A, 20H 


iteration J 


ADD A,#22H 


of WHILE 


MOV 20H.A 


third 


MOV A, 30H 


iteration \ 


ADD A,#22H 


of WHILE 


MOV 30H.A 
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Console I/O Built-in Functions 

There are iwo built-in functions that perform console I/O when expanded: IN and 
OUT. Their names describe the function each performs. IN outputs a greater than 
character '>' as a prompt to the console, and returns the next line typed at the con- 
sole. OUT outputs a string to the console; a call to OUT is replaced by the null 
string. The syntax of both macros is shown below: 

%IN 

%0U7(balanced-text) 

Several examples of how these macros can be used are shown below: 

%OUT(ENTER NUMBER OF PROCESSORS IN SYSTEM?) 
%SET(PROC COUNT. %IN) 
%OUT(ENTER THIS PROCESSOR'S ADDRESS?) 
ADDRESS EQU %IN 

%OUT(ENTER BAUD RATE?) 
%SET(BAUD,%IN) 

The following lines would be displayed at the console: 

ENTER NUMBER OF PROCESSORS IN SYSTEM?>user response 
ENTER THIS PROCESSOR S ADDRESS?>user response 
ENTER BAUD RATE?>user response 



Advanced MPL Concepts 

For most programming problems, the Macro Processing Language syntax described 
above is sufficient. However, in some cases a more complete description of the 
macro processor's function is necessary. 

However, it is impossible to describe all of the subtleties of the macro processor in a 
single chapter. With the rules described in this section, you should be able to discern, 
with a few simple tests, the answer to any specific question about MPL. 



Macro Delimiters 

When we discussed the syntax for defining macros, we showed one type of delimiter. 
The parameter-list was surrounded by parentheses, and parameters were separated 
by commas. Because we used these delimiters to define a macro, a call to the macro 
required that these same delimiters be used. When we discussed the MATCH func- 
tion, we mentioned that a space could be used as a delimiter. In fact the macro pro- 
cessor permits almost any character or group of characters to be used as a delimiter. 

Regardless of the type of delimiter used to define a macro, once it has been defined, 
only the delimiters used in the definition can be used in the macro call. Macros 
defined with parentheses and commas require parentheses and commas in the macro 
call. Macros defined with spaces (or any other delimiter), require that delimiter 
when called. 

Macro delimiters can be divided into three classes: implied blank delimiters, iden- 
tifier (or id) delimiters, and literal delimiters. 
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Implied Blank Delimiters 

Implied blank delimiters are the easiest to use and contribute the most readability 
and flexibility to macro calls and definitions. An implied blank delimiter is one or 
more spaces, tabs or new lines (a carriage-return/linefeed pair) in any order. To 
define a macro that uses the implied blank delimiter, simply place one or more 
spaces, tabs, or new lines surrounding the parameter list and separating the formal 
parameters. 

When you call the macro defined with the implied blank delimiter, each delimiter 
will match a series of spaces, tabs, or new lines. Each parameter in the call begins 
with the first non-blank character, and ends when a blank character is found. 

An example of a macro defined using implied blank delimiters is: 



%*DEFINE(SENTENCE SUBJECT VERB OBJECT ) (THE "/-SUBJECT %VERB %OBJECT.) 



All of the following calls are valid for the above definition: 



Before Macro Expansion After Macro Expansion 

%SENTENCE TIME IS RIPE - THE TIME IS RIPE 

%SENTENCE CATS 
EAT 

FISH - THE CATS EAT FISH 

%SENTENCE 

PEOPLE 

LIKE FREEDOM - THE PEOPLE LIKE FREEDOM 



Identifier Delimiters 



Identifier (Id) delimiters are legal macro identifiers designated as delimiters. To 
define a macro that uses an id delimiter in its call pattern, you must prefix the 
delimiter with the commercial at symbol (@). You must separate the id delimiter 
from the macro identifiers (formal parameters or macro name) by a blank character. 

When calling a macro defined with id delimiters, an implied blank delimiter is 
required to precede the id delimiter, but none is required to follow the id delimiter. 

An example of a macro defined with id delimiters is: 



%*DEFINE(ADD P1 @TO P2 ©AND P3 ) ( 
MOV A,%P1 
ADD A,%P2 
MOV %P2,A 
MOV A,%P1 
ADD A,%P3 
MOV%P3,A 

) 
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The following call (note that no blank character follows the id delimiters TO and 
AND): 

%ADD ATOM TOMOLECULE ANDCRYSTAL 

returns this code when expanded: 

MOV A, ATOM 
ADD A. MOLECULE 
MOV MOLECULE, A 
MOV A, ATOM 
ADD A. CRYSTAL 
MOV CRYSTAL, A 



Literal Delimiters 

The delimiters used when we documented user-defined macros (parentheses and 
commas) were literal delimiters. A literal delimiter can be any character except the 
metacharacter. 

When you define a macro using a literal delimiter, you must use exactly that 
delimiter when you call the macro. If you do not include the specified delimiter 
character as it appears in the definition, it will generate a macro error. 



When defining a macro, you must literalize the delimiter string, if the delimiter you 
wish to use meets any of the following conditions: 

• uses more than one character, 

• uses a macro identifier character (A-Z, 0-9, , or ?), 

• uses a commercial at (@), 

• uses a space, tab, carriage-return, or linefeed, 

You can use the escape function (%n) or the bracket function CFoO) to literalize the 
delimiter string. Several examples of definitions and calls using a variety of literal 
delimiters are shown below: 

This is the simple form shown earlier: 

Before Macro Expansion After Macro Expansion 

%'DEFINE(MAC(A,B))(%A %B) - null string 

%MAC(4.5) - 4 5 

In the following example brackets are used instead of parentheses. The commercial 
at symbol separates parameters: 

%-DEFINE(MOV[A%(@)B]) (MOV %A,%B) - null string 
%MOV[P0@P1| - MOVP0.P1 

In the next two examples, delimiters that could be id delimiters have been defined as 
literal delimiter (the differences are noted): 

%-DEFINE(ADD(A%(AND)B))(ADD%A,%B) - null string 
%ADD#27H) - ADD A . #27H 

Spaces around AND are considered as part of the argument string. 
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To illustrate the differences between id delimiters and literal delimiters, consider the 
following macro definition and call. (A similar macro definition is discussed with id 
delimiters): 

%-DEFINE(ADD P1(TO)P2 %AND) P3 ) ( 
MOV A,%P1 
ADD A,%P2 
MOV %P2.A 
MOV A,%P1 
ADD A,%P3 
MOV %P3,A 

) 

The following call: 

%ADD ATOM TOMOLECULE ANDCRYSTAL 
returns this code when expanded (the TO in ATOM is recognized as the delimiter): 

MOV A, A 

ADD A,M TOMOLECULE 
MOV M TOMOLECULE. A 
MOV A, A 
ADD A. CRYSTAL 
MOV CRYSTAL, A 



Literal versus Normal Mode 

In normal mode, the macro processor scans text looking for the metacharacter. 
When it finds one, it begins expanding the macro call. Parameters are substituted 
and macro calls are expanded. This is the usual operation of the macro processor, 
but sometimes it is necessary to modify this mode of operation. The most common 
use of the literal mode is to prevent macro expansion. The literal character in 
DEFINE prevents the expansion of macros in the macro-body until you call the 
macro. 

When you place the literal character in a DEFINE call, the macro processor shifts to 
literal mode while expanding the call. The effect is similar to surrounding the entire 
call with the bracket function. Parameters to the literalized call are expanded, the 
escape, comment, and bracket functions are also expanded, but no further process- 
ing is performed. If there are any calls to other macros, they are not expanded. 

If there are no parameters in the macro being defined, the DEFINE built-in function 
can be called without the literal character. If the macro uses parameters, the macro 
processor will attempt to evaluate the formal parameters in the macro-body as 
parameterless macro calls. 

The following example illustrates the difference between defining a macro in literal 
mode and normal mode: 



%SET(TOM,1) 

%'DEFINE(AB) (%EVAL(%TOM)) 
%DEFINE(CD) (%EVAL(%TOM)) 
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When AB and CD are defined, TOM is equal to l. The macro body of AB has not 
been evaluated due to the literal character, but the macro body of CD has been com- 
pletely evaluated, since the literal character is not used in the definition. Changing 
the value of TOM has no effect on CD, but it changes the return value of AB, as 
illustrated below: 

Before Macro Expansion After Macro Expansion 

%SET(TOM,2| 

%AB - 02H 

%CD - 01 H 

The macros themselves can be called with the literal character. The return value 
then is the unexpanded body: 

%'CD - 01H 

%'AB - %EVAL(%TOM) 

The literalized calls to AB and CD show that CD evaluates to 01 H, while AB con- 
tains a macro call to EVAL with %TOM as its parameter. 



Algorithm for Evaluating Macro Calls 

The Algorithm the macro processor uses for evaluating the source file can be seen in 
6 steps: 

1 . Scan source until metacharacter is found. 

2. Isolate call pattern. See note below . 

3. If macro has parameters, expand each parameter from left to right (initiate step 
one on actual parameter), before expanding next parameter. 

4. Substitute actual parameters for formal parameters in macro body. 

5. If literal character is not used, initiate step one on macro body. 

6. Insert result into output stream. 

NOTE 

When isolating the call pattern, the macro processor is actually scann- 
ing input for the specified delimiter. All text found between delimiters 
is considered the actual parameter. For this reason Id delimiters need 
not be terminated by spaces in a call, and the 'TO' in 'ATOM' satisfied 
the literal delimiter, when the 'M TOMOLECULE ' became the second 
parameter. 

The terms 'input stream' and 'output stream' are used, because the return value of 
one macro may be a parameter to another. On the first iteration, the input stream is 
the source file. On the final iteration, the output stream is the temporary workfile 
that passes to the assembler. 

The examples below illustrate the macro processor's evaluation algorithm: 
%SET(TOM,3) 

%'DEFINE(STEVE)(%SET(TOM,%TOM-1)%TOM) 

%'DEFINE(ADAM(A,B))( 

DB %A, %B, %A, %B, %A, %B 

) 
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Here is a call ADAM in the normal mode with TOM as the first actual parameter 
and STEVE as the second actual parameter. The first parameter is completely 
expanded before the second parameter is expanded. After the call to ADAM has 
been completely expanded, TOM will have the value 02H. 

Before Macro Expansion After Macro Expansion 

% ADAM(%TOM,%STEVE) - DB 03H, 02H, 03H, 02H, 03H, 02H 

Now reverse the order of the two actual parameters. In this call to ADAM, STEVE 
is expanded first (and TOM is decremented) before the second parameter is 
evaluated. Both parameters have the same value. 

%SET(TOM,3) 

%ADAM(%STEVE,%TOM) - DB 02H, 02H, 02H. 02H, 02H. 02H 

Now we will literalize the call to STEVE when it appears in the first actual 
parameter. This prevents STEVE from being expanded until it is inserted in the 
macro body, then it is expanded for each replacement of the formal parameters. 
Tom is evaluated before the substitution in the macro body. 



%SET(TOM.3) 
%ADAM(%-STEVE.%TOM) 



- DB02H,03H,01H.03H,00H.03H 



Assembler Operation and Controls 



This chapter describes how to invoke the MCS-5 1 Macro Assembler from the DOS 
operating system. It also describes the assembler controls in detail. 

How to Invoke the MCS -51 Macro Assembler 

The general syntax of the command to invoke the assembler is 

[directory I device JASM51 source file [controls ] 

where 

directory I device is the directory or device in which ASM 51 resides. 

source file is the pathname of the file containing the ASM51 source 

module. 

controls is an optional sequence of assembler controls. 

The controls are described in detail later in this chapter. 

ASM51 normally produces two output files. One contains a formatted listing of your 
source code. Unless you specify a particular filename whith the PRINT control, the 
formatted listing resides on the same device and has the same name as the source 
file, but with the extension .LST. (For more information about the listing file, see 
Chapter 7 of this manual.) Similarly, unless you specify a particular filename with 
the OBJECT control, the object file produced by the assembler resides on the same 
disk and has the same name as the source file, but with the extesion .OBJ. 

To illustrate the construction and function of the invocation line, consider the follow- 
ing example: 

>ASM51 A:PROG.SRC 

Here a source file, PROG.SRC on device A:, is to be assembled by ASM51. Because 
no controls have been specified, the listing file has the name PROG.LST, and the 
object file has the name PROG.OBJ, the default conditions. Both the listing and the 
object file reside on device A:. Default conditions will be in effect for all other control 
options. 

You can continue the invocation line on one or more additional lines by entering the 
ampersand (&) before you enter the carriage return/line feed. The next line 
automatically appears with the continuation prompt. Comments can also be entered 
on the invocation line by placing comments after the ampersand; the compiler ignores 
all characters that appear after the ampersand but before the carriage return/line 
feed that terminates the line, as in the following example: 

>ASM51 PROG.SRC & The assembler is being run 

>>TITLE( PROJECT REVIEW ) & for the Project Review file. 
>>GEN 

Refer to your DOS user's guide for information on submitting batch file commands. 



If errors are detected in the invocation line, they are fatal, and the assembler aborts 
without processing the source program. 
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Assembler Controls 



Assembler controls may be entered in the invocation line as described above or on a 
control line in your source code. The general format for control lines is shown below: 

$ Control List{; Comment] 

The dollar sign ($) must be the first character on the line. The control list is zero or 
more controls separated by one or more spaces or tabs. The comment is optional. 

ASM51 has two classes of controls: primary and general. The primary controls are 
set in the invocation line or the primary control lines and remain in effect throughout 
the assembly. For this reason, primary controls may be used only in the invocation 
line or in a control line at the beginning of the program. Only other control lines 
(that do not contain the INCLUDE control) may precede a line containing a primary 
control. The INCLUDE control terminates processing of primary controls. 

If a Primary Control is specified in the invocation line and in the primary control 
lines, the first time counts. This enables the programmer to override primary controls 
via the invocation line. 

The general controls are used to control the immediate action of the assembler. 
Typically their status is set and modified during an assembly. Control lines contain- 
ing only general controls may be placed anywhere in your source code. 

Table 6- 1 lists all of the controls, their abbreviations, their default values, and a brief 
description of each. 



Table 6-1. Assembler Controls 



Name 


Primary ' 
General 


Default 


Abbrev. 


Meaning 


DATE(dare) 


P 


DATE( ) 


DA 


Places string in header {9 characters 
maximum) 


DEBUG 


P 


NODEBUG 


DB 


Outputs debug symbol information to 
obiect file 


NODEBUG 


P 




NODB 


Symbol information not placed in 
object file 


EJECT 


G 


Not Applicable 


EJ 


Continue listing on next page 


ERRORPRINT[(F/(.E)| 


P 


NOERRORPRINT 


EP 


Designates a file to receive error 
messages in addition to the listing file 
defaults to :co: 


NOERRORPRINT 


P 




NOEP 


Designates that error messages will be 
printed in listing file only 


GEN 


G 


GENONLY 


GE 


Generates a full listing of the macro 
expansion process including macro 
calls in the listing file 


GENONLY 


G 




GO 


List only the fully expanded source as 
if all lines generated by a macro call 
were already in source file 


NOGEN 


G 




NOGE 


List only the original source text in 
listing file 
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Table 6-1 . Assembler Controls (Cont'd . ) 



Name 


Primary 
General 


Default 


Abbrev. 


Meaning 


INCLUDE {FILE) 


G 


Not Applicable 


IC 


Designates a file to be included as part of 
the program 


LIST 


G 


LIST 


LI 


Print subsequent lines of source in listing 
file 


NOLIST 


Q 




NOLI 


Do not print subsequent lines of source in 
listing file 


MACROKmemoercenMl 


P 


MACRO(50) 


MR 


Evaluate and expand all macro calls. 
Allocate percentage of free memory for 
macro processing 


NOMACRO 


P 




NOMR 


Do not evaluate macro calls 


M0D51 


p 


MOD51 


MO 


Recognize the 8051 -specific predefined 
special registers 


N0M0D51 


p 




NOMO 


Do not recognize the 8051-specific 
predefined special registers 


OBJECT[(FH.E)] 


p 


OBJECT(source-OBJ) 


OJ 


Designate file to receive object code 


NfinR IF(":T 


p 




NOOJ 


Designates that no object file will be 
created 


PAGING 


p 


PAGING 


PI 


Designates that listing will be broken into 
pages and each will have a header 


NOPAGING 


p 




NOPI 


Designates thai listing will contain no page 
breaks 


PAGELENGTH(n) 


p 


PAGELENGTH(60) 


PL 


Sets maximum number of lines in each 
page of listing file (range = 10 — 65,535) 


PAGEWIDTHfn ) 


p 


PAGEWIDTHI.120) 


PW 


Sets maximum number of characters in 
each line of listing file (range - 72—132) 


PRINT[(F/LF)] 


p 


PRINT(SOuTce.LST) 


PR 


Designates file to receive source listing 


NOPRINT 


p 




NOPR 


Designates that no listing file will be 
created 


SAVE 


Q 


Not Applicable 


SA 


Stores current control setting for LIST and 
GEN 


RESTORE 


G 




RS 


Restores control setting from SAVE stack 


REGISTERBANK(rf)....) 
rb - 0—3 


P 


REGISTERBANK(O) 


RB 


Indicates one or more banks used in 
program module 


NOREGISTERBANK 


P 




NORB 


Indicates that no banks are used 


SYMBOLS 


P 


SYMBOLS 


SB 


Creates a formatted table of all symbols 
used in program 


NOSYMBOLS 


P 




NOSB 


No symbol table created 


TITLE(sfrin 9 ) 


G 


TITLE, | 


TT 


Places a string in all subsequent page 
headers (maximum 60 characters) 


XREF 


P 


NOXREF 


XR 


Creates a cross reference listing of all 
symbols used in program 




P 




NOXR 


No cross reference list created 



6-4 MCS^-SI Macro Assembler 



Control Definitions 



Control Switch Name: DATE 



Abbreviation: DA 

Arguments: (string) (Nine characters maximum) 

Control Class: Primary 

Default: (operating system date) 

The assembler takes the character string specified as the argument 
or the operating system date and inserts it in the header. If you 
specify less than nine characters, then it will be padded with blanks. 
If more than nine characters are specified, then the character string 
will be truncated to the first nine characters. DATE is overridden 
by NOPRINT. 

NOTE 

Any parentheses in the DATE string must be balanced. 

$T1TLE(PR0JECT S.W.B. REV. 27) DATE(1 -1 7-83) 
(Header will look like this) 
MCS-51 MACRO ASSEMBLER PROJECT S.W.B. REV. 27 1-17-83 PAGE 1 



Control Switch Name: 



DEBUG/NODEBUG 



Arguments: 
Control Class: 
Default: 
Definition: 



Example: 



DB/NODB 
None 
Primary 
NODEBUG 

Indicates whether debug symbol information shall be output to 
object file. If DEBUG is in effect the debug information will be 
output. This control must be used if you wish to run the program 
with an ICE-51. 

DEBUG is overridden by NOOBJECT. 
$DEBUG 
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Control Switch Name: EJECT 



Abbreviation: 



EJ 



Arguments: None 
Control Class: General 

Default: (New page starred when PAGELENGTH reached) 

Definition: Inserts formfeed into listing file, after the control line containing 

the EJECT, and generates a header at top of the next page. The 
control is ignored if NOPAGING, NOPRINT, or NOLIST is in 
effect. 



Example: 



$EJECT 



Control Switch Name: ERRORPRINT/NOERRORPRINT 



Abbreviation: EP/NOEP 

Arguments: (Filename) (Indicates file to receive error messages— argument 
optional. ) 

Control Class: Primary 

Default: NOERRORPRINT 



Definition: When ERRORPR1NT is in effect, indicates that all erroneous lines 

of source and the corresponding error message shall be output to 
the specified file. This will not inhibit errors from being placed in 
listing file. If no argument is specified to ERRORPRINT, then 
erroneous lines and error messages will be displayed at the console. 



Example: 



SERRORPRINT 
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Control Switch Name: 



GEN/GENONLY/NOGEN 



Abbreviation: GE/GO/NOGE 
None 

Control Class: General 
Default: GENONLY 

Definition: NOGEN indicates that only the contents of the source file shall be 

output to the listing file with macro call expansion not shown. 
Expansion will take place, but source lines generated will not be 
displayed in listing file, only the macro call. 

GENONLY indicates that only the fully expanded macro calls will 
appear in the listing. The listing file appears as if the expanded 
text was originally in the source file with no macro calls. The macro 
calls will not be displayed, but the source lines generated by the 
calls will be in the listing file. 

GEN indicates that each macro call shall be expanded showing 
nesting of macro calls. The macro call and the source lines gener- 
ated by the macro call will be displayed in the listing file. 

These cont.ols are overridden by NOPRINT and NOLIST. (See 
Chapter 7 for examples of a macro calls listed with GEN. 
GENONLY. and NOGEN in effect.) 

Example: $NOGEN 



Control Switch Name: 



INCLUDE 



Abbreviation: IC 

Arguments: (Filename) (Identifies file to be included into program) 
Control Class: General 
Default: Not applicable 

Definition: Inserts the contents of the file specified in the argument into the 

program immediately following the control line. INCLUDE files 
may be nested 

The INCLUDE control may not appear in the invocation line, and 
it terminates processing of primary controls in the source. 



Example: 



$INCLUDE(IOPACK.SRC) 
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Control Switch Name: 



LIST/NOLIST 



Abbreviation: 
Arguments: 
Control Class: 
Default: 



LI/NOLI 
None 
General 
LIST 

Indicates whether subsequent lines of source text shall be displayed 
in listing file. A LIST control following a NOLIST will not be 
displayed, but listing will continue with the next sequential line. 
NOPRINT overrides LIST. 

NOTE 

Lines causing errors will be listed when NOLIST is in 
effect. 



Example: 



$NOLIST 



Control Switch Name: MACRO/NOMACRO 



Abbreviation: MR/NOMR 

Arguments: (mempercent) (Optional. Indicates the percentage of the free 

memory to be used for macro processing. ) 

Control Class: Primary 
Default: MACRO(50) 

Definition: Indicates whether macro calls shall be expanded. If NOMACRO 

is specified all macro calls will not be processed as macros. The 
NOMACRO control will free additional symbol table space for 
user-defined symbols. 



Example: $NOMACRO 
$MACRO(30) 
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Control Switch Name: M0D51 /N0M0D51 



MO/NOMO 
None 

Control Class: Primary 
MOD51 



This control maintains compatibility with previous versions of 
ASMS I. The processor recognizes the predefined symbols speci- 
fying the BIT and DATA address of the special memory-mapped 
registers specific to the 8051 chip in the default case(MOD5l). If 
NOMOD51 is specified, the assembler does not recognize the 8051 
specific predefined special register names. 

To specify other memory-mapped registers (e.g., those registers 
specific to the 8052 chip), use NOMOD51 and then INCLUDE 
in your program a PDF file (e.g., REG52.PDF, which specifies the 
symbolic names for the 8052 BIT and DATA addresses). See also 
Appendix L. 

SNOMOD51 



Control Switch Name: OBJECT/NOOBJECT 
OJ/NOOJ 

(Filename) (Indicates file to receive object code — argument 
optional. ) 

Control Class: Primary 

Default: OBJECT(sourceffie.OBJ) 

Definition: Indicates whether object code shall be generated, and if so, the file 

that will receive it. If you do not specify the argument, the object 
file will be source file.OflS. 



Example: 



$OBJECT(FINAL.REV) 
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Control Switch Name: PAGING/NOPAGING 



Abbreviation: PI/NOPI 

Arguments: None 

Control Class: Primary 

Default: PAGING 



Definition: Indicates whether page breaks shall be included in listing file. If 

NOPAGING, then there will be no page breaks in the file, and 
lines will appear listed consecutively. A single header will be 
included at the top of the file. EJECT and PAGELENGTH 
controls will be ignored. 

If PAGING, a formfeed and a page header will be inserted into 
the listing file whenever the number of lines since the last page 
break equals the PAGELENGTH value, or an EJECT control is 
encountered. The header includes the assembler designation, the 
name of the source file, the TITLE and DATE strings (if speci- 
fied), and the page number. 

Example: $ NOPAGING 



Control Switch Name: PAGELENGTH 



Abbreviation: PL 

Arguments: (n) (Decimal number greater than 9.) 

Control Class: Primary 

Default: PAGELENGTH(60) 

Definition: Indicates the maximum number of printed lines on each page of 

the listing file. This number includes the page heading. The 
minimum value for PAGELENGTH is 10. Values less than 10 will 
be treated as 10. The maximum value permitted in the argument 

is 65,535. 



Example: $ PAGELENGTH(1 32) 
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Control Switch Name: PAGEWIDTH 
Abbreviation: PW 

Arguments: (n) (Number indicates maximum characters per line. ) 

Control Class: Primary 

Default: PAGEWIDTH(120) 

Definition: Indicates the maximum number of characters printed on a line in 

the listing file. The range of values permitted is from 72 to 132; 
values less than 72 are set to 72; values greater than 132 are set to 
132. 

Listing lines that exceed the PAGEWIDTH value will be wrapped 
around on the next lines in the listing. 

Example: $ PAGEWIDTH(80) 

Control Switch Name: PRINT/NOPRINT 
Abbreviation: PR/NOPR 

Arguments: (Filename) (Indicates file to receive assembler listing— argument 
optional.} 

Control Class: Primary 

Default: PRINT(sourceftte.LST) 

Definition: Indicates whether formatted source listing shall be generated, and, 

if so, what file will receive it. If you do not specify the argument, 
the listing file will be sourcefile. LST. NOPRINT indicates no 
listing file will be made. 

Example: ASM51 PROG.SRC PRINT(:LP:) & print listing at line printer 
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Control Switch Name: SAVE/RESTORE 



Abbreviation: 
Arguments: 
Control Class: 
Default: 
Definition: 



SA/RS 

None 

General 

Not applicable 

Permits you to save and restore the state of the LIST and GEN 
controls. SAVE stores the setting of these controls on the SAVE 
stack, which is internal to the assembler. RESTORE restores the 
setting of the controls to the values most recently saved, but not 
yet restored. SAVEs can be nested to a depth of 8. 

NOTE 

SAVE uses the values that were in effect on the line prior 
to the SAVE control line. Therefore, if the LIST control 
is in effect and the assembler encounters a control line 
containing NOLIST and SAVE (in any order on the line), 
the status LIST is saved on the stack. (The lines following 
the control line are not listed until a LIST or RESTORE 
is encountered.) 



Example: 



$SAVE 



Control Switch Name: REGISTERBANK / NOREGISTERBANK 



Abbreviation: RB / NORB 

Arguments: (rb, ...) (One or more of ihe permissible bank 

rb = 0, 1 , 2, or 3 numbers separated by commas.) 

Control Class: Primary 



Default: REGISTERBANK(O) 

Definition: Indicates the register banks used in the program module. This 

information is transferred to the RL5I and used for allocation of 
register bank memory. NORB specifies that no memory is initially 
reserved for register banks. Note that the USING directive also 
reserves register banks. 



Example: 



REGISTERBANK(0,1) 
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Control Switch Name: 



SYMBOLS/NOSYMBOLS 



Abbreviation: 
Arguments: 
Control Class: 



Example: 



SB/NOSB 
None 
Primary 
SYMBOLS 

Indicates whether a symbol table shall be listed. NOSYMBOLS 
indicates no symbol table. SYMBOLS causes the table to be listed. 
NOSYMBOLS is overridden by XREF. SYMBOLS is overridden 
by NOPRINT. (See Chapter 7 for an example symbol table listing.) 

$NOSYMBOLS 



Control Switch Name: 



TITLE 



Abbreviation: 



TT 



Arguments: (String) ( ( /> to 60 diameters. ) 
Control Class: General 
Default: (Spaces Inserted) 

Definition: Permits you to include a title lor the program. It will be printed in 

the header of every subsequent page. Titles longer than 60 charac- 
ters will be truncated to the first 60 characters. (See Chapter 7 for 
an example of the title in the header.) 

NOTE 

Any parentheses in Ihe TITLL string must be balanced. 



Example: 



$TITLE(Final Production Run) 
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Control Switch Name: XREF/NOXREF 



Abbreviation: XR/NOXR 

Arguments: None 

Control Class: Primary 

Default: NOXREF 



Definition: Indicates that a cross reference table of the use of symbols shall be 

added to the symbol table. Each cross reference table will list the 
line numbers of the lines that define the value of a symbol, and all 
of the lines that reference the symbol. A hash mark (#) follows the 
numbers of the lines that define the symbols value. XREF is 
overridden by NOPRINT. (See Chapter 7 for an example of a 
symbol table listing with XREF.) 



Example: $XREF 



Assembler Output: Error Messages 
and Listing File Format 




This chapter discusses the meaning of error messages issued by ASM51 . The format of the 
listing file is also described. 



Error Messages and Recovery 

All error messages issued by ASM51 are either displayed on the console or listed in the 
listing file. Fatal errors, such as invocation line errors, are listed at the console and cause 
ASM5I to abnormally terminate. Errors detected in the source file do not cause the 
assembler to abort and usually allow at least the listing to continue. 



Console Error Messages 

Upon detecting certain catastrophic conditions with the system hardware, or in the invo- 
cation line or one of the primary control lines, ASM51 will print an informative message 
at the console and abort processing. 

These errors fall into three broad classes: I/O errors, internal errors and invocation line 
errors. 

A list of these fatal control error messages and a description of the cause of each is shown 
below. 

I/O Errors 

I/O error messages print with the following format: 



ASM51 I/O ERROR- 
FILE: file type 
NAME: filename 
ERROR: UDI exception 

ASM51 TERMINATED 

The list of possible file types is: 

SOURCE 

PRINT 

OBJECT 

INCLUDE 

ERRORPRINT 

ASM 51 WORKFILE 

ASM51 OVERLAY number 



The list of possible error numbers is: 

4— ILLEGAL PATH NAME 

5 — ILLEGAL OR UNRECOGNIZED DEVICE IN PATH 
9 — DIRECTORY FULL 

12 - ATTEMPT TO OPEN ALREADY OPEN FILE 

13- NOSUCH FILE 

14- WRITE PROTECTED FILE 

22- OUTPUT MODE IMPOSSIBLE FOR SPECIFIED FILE 

23- NO FILENAME SPECIFIED FOR A DISK FILE 
28-NULL FILE EXTENSION 
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ASM51 Internal Errors 

The ASM51 internal errors indicate that an internal consistency check failed. A 
likely cause is that one of the files containing the assembler's overlays was corrupted 
or that a hardware failure occurred. If the problem persists, contact Intel Corpora- 
tion via the Software Problem report. 

These messages print in the following format: 

**** ASM51 INTERNAL ERROR: message 

Be sure to include the exact text of the message on the problem report. 



Invocation Line Errors 

The invocation line error messages print in the following format: 

ASM51 FATAL ERROR- 
error message 

The possible error messages are: 

NO SOURCE FILE FOUND IN INVOCATION 

If ASM51 scans the invocation line and cannot find the source file name, then this 
error will be issued and assembly aborted. 

UNRECOGNIZABLE SOURCE FILE NAME 

If the first character after "ASM5I" on the invocation line is not an "&" or a file 
character (i.e., ":", letter, digit, "."), then ASM51 issues this error and aborts. 

ILLEGAL SOURCE FILE SPECIFICATION 

If the source file is not a legal file name (does not conform to the operating system 
rules for a path name), then this error is issued. 

SOURCE TEXT MUST COME FROM A FILE 
The source text must always come from a file, not devices like sTJ: or :LP:. 

NOT ENOUGH MEMORY 

If there is not enough memory in your operating system, then this error message will 
print out and ASM51 will abort. 

If identical files are specified: 

_ AND _ FILES ARE THE SAME 

where the "_" can be any of SOURCE, PRINT, OBJECT, and ERRORPRINT. It 
doesn't make sense for any of these files to be the same. 
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If ASM51 encounters anything other than a "," or a ")" when it is looking for the 
next workfile, then this error is issued. 

BAD PAGELENGTH 
BAD PAGEWIDTH 

The parameter to pagelength and pagewidth must be a decimal number. The number 
may have leading and trailing blanks, but if there are any other extra characters in 
the parameter, then this error will be issued. 

PAGELENGTH MISSING A PARAMETER 
PAGEWIDTH MISSING A PARAMETER 
DATE MISSING A PARAMETER 

These commands require parameters. If there is no parameter, then assembly is 
aborted. 

CANNOT HAVE INCLUDE IN INVOCATION 

The INCLUDE command may appear only in the source text. Don't forget that 
command lines in the source file can contain primary commands, but only if they are 
the very first lines in the file. Also, if one of these lines has an INCLUDE on it, then 
that ends the primary command lines. 

EOL ENCOUNTERED IN PARAMETER 
A parameter in the invocation line is missing a right parenthesis. 

COMMAND TOO LONG 
A command word longer than 128 characters— very unlikely. 

ILLEGAL CHARACTER IN INVOCATION 

There was an illegal character in the invocation line— usually a typing error. (See 
error 403.) 

UNRECOGNIZED COMMAND: <conlrol-name> 
This message is issued if a problem occurs in the invocation. 

NO PARAMETER ALLOWED WITH control 
The control specified may not be associated with the parameter. 

TITLE MISSING A PARAMETER 
The TITLE control was specified without the title string itself as a parameter. 

TOO MANY RESTORES 
More RESTORE controls encountered than the respective SAVE controls. 

NO PARAMETER GIVEN FOR "REGISTER BANKS" 

The REGISTER BANKS control was specified without the register bank numbers 
as parameters. 

ERROR IN PARAMETER LIST FOR "REGISTER BANKS" 

The parameter list of the REG1STERBANKS control contains an error. 
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Listing File Error Messages 

ASM51 features an advanced error-reporting mechanism. Some messages pinpoint 
the symbol or character at which the error was detected. Error messages printed in 
the source file are inserted into the listing after the lines on which the errors were 
detected. 

They are of the following format: 

••• ERROR #eee, LINE #/// (ppp), message 
where: 

eee is the error number 

/// is the number of the line on which the error occurred 

ppp is the line containing the last previous error 

message is the English message corresponding to the error number 

If the error is detected in pass 2, the clause "(PASS 2)" precedes the message. 
"(MACRO)" precedes the message for macro errors; "(CONTROL)" precedes the 
message for control errors. 

Errors which refer to character or symbol in a particular line of the source file do so 
by printing a pointer to the first item in the line that is not valid; e.g.: 



The up arrow or vertical bar points to the first incorrect character in the line. 

Error messages that appear in the listing file are given numbers. The numbers corres- 
pond to classes of errors. The classes of errors and the numbers reserved for these 
classes is shown in the list below r: 

- 99 Source File Errors 
300 - 399 Macro Errors 
400 - 499 Control Errors 
800 - 899 Special Assembler Errors 
900 - 999 Fatal Errors 

Errors numbered less than 800 are ordinary, non-fatal errors. Assembly of the error 
line can usually be regarded as suspect, but subsequent lines will be assembled. If an 
error occurs within a macro definition, the definition does not take place. 



Source File Error Messages 

There follows a list of the error messages generated by ASM51, ordered by error 
number. 

•" ERROR #1 SYNTAX ERROR 

This message is preceded by a pointer to the character at which the syntax error 
was detected. 
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ASM51 contains an internally-encoded grammar of the MCS-51 assembly 
language and requires your program to conform to that grammar. The syntax 
error is recognized at the item indicated in the error message; e.g., 

... TEMP SER 10 



gives a syntax error at the S. "SER" is unrecognized. However, sometimes the 
error is not detected until one or more characters later; e.g., 

... SETB EQU 1 



gives a syntax error at "EQU". The error is that SETB is already defined as an 
instruction. The assembler interprets the line as a SETB instruction with 
"EQU 1" as the operand field. Since the keyword "EQU" is not a legal 
operand the "EQU" is flagged, even though the "SETB" is the user's 
mistake. 

ASM51 discards the rest of the line when it finds a syntax error. 
ERROR #2 SOURCE LINE LISTING TERMINATED AT 255 CHARACTERS 

Listing of the source line was stopped at 255 characters. The entire line was 
interpreted, only the listing is incomplete. 

••• ERROR #3 ARITHMETIC OVERFLOW IN NUMERIC CONSTANT 

This error is reported whenever the value expressed by a constant exceeds the 
internal representation of the assembler (65,535). 

"• ERROR #4 ATTEMPT TO DIVIDE BY ZERO 

This error occurs when the right hand side of a division or MOD operator 
evaluates to zero. 

*** ERROR #5 EXPRESSION WITH FORWARD REFERENCE NOT ALLOWED 

Forward references are permitted only in the expression argument to DB, DW, 
and machine instructions. Change the expression to remove the forward 
reference, or define the symbols earlier in the program. 

• • • ERROR #6 TYPE OF SET SYMBOL DOES NOT ALLOW REDEFINITION 

This error occurs when the symbol being defined in a SET directive is a 
predefined assembler symbol or has been previously defined not using SET 
directive. For example, the following lines would cause this error on the 
second line. 

SKIP 1 : ADD A,R1 

SKIP_1 SET 22D 

••• ERROR #7 SYMBOL ALREADY DEFINED 

This message is given when the symbol has already been defined. To correct 
this error, use a different symbol name. 



• • ERROR #8 ATTEMPT TO ADDRESS NON-BIT-ADDRESSABLE BIT 
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This error is caused when the left hand side of the bit selector (.) is not one of 
the bit addressable bytes. (See errors 40 and 9.) Figure 2-2 shows all bit- 
addressable bytes. Several examples of lines that would cause this type of error 
are shown below. 

JB10H.5.LOOP 
CLR7FH.0 
MOV C.0AFH.3 

••• ERROR #9 BAD BITOFFSET IN BIT ADDRESS EXPRESSION 

This error is caused when the right hand side of the bit selector (.) is out of 
range (0-7). The assembler uses in its place. The byte address, if correct, 
remains the same. (See errors 8, and 40.) Several examples of lines that would 
generate this error are shown below. 

CLR 25H.10 
SETB 26H.5 + 4 
CPL PSW.-1 



'•• ERROR #10 TEXT FOUND BEYOND END STATEMENT - IGNORED 

This is a warning — there are no ill effects. The extra text appears in the listing 
file, but it is not assembled. 

"• ERROR #11 PREMATURE END OF FILE (NO END STATEMENT) 

There are no ill effects from omitting the END statement, other than this 
message. 

•• • ERROR #12 ILLEGAL CHARACTER IN NUMERIC CONSTANT 

Numeric constants begin with decimal digits, and are delimited by the first 
non-numeric character. The set of legal characters for a constant is determined 
by the base: 

1. Base 2: 0,1, and the concluding B. 

2. Base 8: 0-7. and the concluding Q or O. 

3. Base 10: 0-9, and the concluding D or null. 

4. Base 16: 0-9, A-F, and the concluding H. 

ERROR #13 ILLEGAL USE OF REGISTER NAME IN EXPRESSION 

This error is caused by placing a forward reference symbol, defined as a 
register, in a numeric expression. An example of this type of error is shown 
below: 

DBREG0 
REG0 EQU R0 

ERROR #14 SYMBOL IN LABEL FIELD ALREADY DEFINED 

You can define a label only once in your program. If the symbol name has 
been defined anywhere else in the program this error will be generated. 

•" ERROR #15 ILLEGAL CHARACTER 

This message is preceded by a pointer to the illegal character. 
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A character that is not accepted by ASM51 was found in the input file. Either 
it is an unprintable ASCII character, in which case it is printed as an up arrow 
( A ), or it is printable but has no function in the assembly language. Edit the 
file to remove the illegal character. 

••• ERROR #16 MORE ERRORS DETECTED, NOT REPORTED 

After the ninth source file Error on a given source line, this message is given 
and no more errors are reported for that line. Normal reporting resumes on the 
next source line. (See errors 300 and 400.) 

ERROR #17 ARITHMETIC OVERFLOW IN LOCATION COUNTER 

This error is reported whenever the DS, DB1T, or ORG directive attempts to 
increase the location counter beyond the limits of the current address space. 
This may occur, for example, in CSEG when instructions cause the location 
counter to increment above 65,535. 

•" ERROR #18 UNDEFINED SYMBOL 

This error is reported when an undefined symbol occurs in an expression. Zero 
is used in its place— this may cause subsequent errors. 

• * * ERROR #19 VALUE WILL NOT FIT INTO A BYTE 

This error is issued whenever the expression used for a numeric operand that is 
encoded as a single byte is not in the range -256 to +255. 

••• ERROR #20 OPERATION INVALID IN THIS SEGMENT 

This error will occur if you use the DB1T directive not in a BIT type segment; 
or a DS directive in a BIT type segment, or if you attempt to initialize memory 
(use DB, DW, or a machine instruction) in a segment with different type than 
CODE. 

•" ERROR #21 STRING TERMINATED BY END-OF-LINE 

All strings must be completely contained on one line. 

"• ERROR #22 STRING LONGER THAN 2 CHARACTERS NOT ALLOWED IN THIS CONTEXT 

Outside of the DB directive all strings are treated as absolute numbers; hence, 
strings of 3 or more characters are overflow quantities. If this error occurs in a 
DW directive, you probably should be using DB. 

••• ERROR #23 STRING, NUMBER, OR IDENTIFIER CANNOT EXCEED 255 CHARACTERS 

The maximum length of a character string (including surrounding quotes), a 
number, or an identifier is 255 characters. 

•" ERROR #24 DESTINATION ADDRESS OUTOF RANGE FOR INBLOCK REFERENCE 

This error is caused by specifying an address that is outside the current 2K byte 
block. The current block is defined by the five most significant bits of the 
address of the next instruction. 
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" • ERROR #25 DESTINATION ADDRESS OUT OF RANGE FOR RELATIVE REFERENCE 

A relative jump has a byte range (-128 to +127) from the instruction that 
follows the jump instruction. Any address outside of this range will generate 
this error. You can correct this error in one of two ways: if the jump has a 
logical complement (e.g., JC and JNC), the following change could be made: 

JCTOP to JNC SKIP 

JMPTOP 

SKIP: 

If the instruction has no logical complement, then the following change could 
be made 

DJNZRO.TOP to DJNZRO.SKIP 1 

JMPSKIP 2 
SKIP 1: JMPTOP 
SKIP 2: 

■•• ERROR #26 SEGMENT SYMBOL EXPECTED 

The error occurs when the symbol specified by the RSEG directive is not a seg- 
ment symbol, i.e., is not defined previously using the SEGMENT directive. 

•" ERROR #27 ABSOLUTE EXPRESSION EXPECTED 

The error occurs when the operand to the follow ing directives is not absolute: 
DS, DBIT, USING, CSEG, XSEG, DSEG, BSEG, and ISEG. In addition, the 
bit-offset in a byte. bit form should also be absolute. 

• •• ERROR #28 REFERENCE NOT TO CURRENT SEGMENT 

The error occurs in two cases: if a relocatable expression in an ORG directive 
does not specify the current active segment; or if the absolute expression speci- 
fying the base address in a segment select directive is not of the correct segment 
type. 

Examples 

RSEG CODE SEG1 
CODE SYM1 : DB 1 

RSEG DATA SEG1 

ORG CODE SYMB1 ;error#28 

CODE__SYMB2 CODE 200H 

DSEG AT CODE _SYM2 -.error #28 

••• ERROR #29 IDATA SEGMENT ADDRESS EXPECTED 

The symbol specified on the left hand side of the bit selector(.) is not segment 
type DATA, or not in a bit-addressable relocatable type segment. The numeric 
value is used if possible, but may cause other errors. (See errors 37 and 8.) 

••• ERROR #30 PUBLIC ATTRIBUTE NOT ALLOWED FOR THIS SYMBOL 

Occurs if the user attempts to define as public either segment symbols, external 
symbols, or predefined symbols. 



•• ERROR #31 EXTERNAL REFERENCE NOT ALLOWED IN THIS CONTEXT 
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••■ ERROR #32 SEGMENT REFERENCE NOT ALLOWED IN THIS CONTEXT 

Occurs if an external/segment symbol appears in a symbol definition directive 
(EQU, SET, DATA, etc.); or in contexts when absolute expressions are 
required (see error #27). 

• • • ERROR #33 TOO MANY RELOCATABLE SEGMENTS 

The maximum number of relocatable segments has been exceeded. 
•'• ERROR #34 TOO MANY EXTERNAL SYMBOLS 

The maximum number of relocatable segments has been exceeded. 

••■ ERROR #35 LOCATION COUNTER MAY NOT POINT BELOW SEGMENT BASE 

Occurs if the user attempts, using the ORG directive, to set the location 
counter below the beginning of the current absolute segment. 

Example 

CSEG AT 200H ;starts an absolute segment at 200H 
ORG 1 FFH ;error#35 

••• ERROR #36 CODE SEGMENT ADDRESS EXPECTED 
• ' • ERROR #3? DATA SEGMENT ADDRESS EXPECTED 
■•• ERROR #38 XDATA SEGMENT ADDRESS EXPECTED 
••• ERROR #39 BIT SEGMENT ADDRESS EXPECTED 

These errors are caused by specifying a symbol with the wrong segment type in 
an operand to an instruction. The numeric value of that symbol is used, but it 
may cause subsequent errors (e.g., error 17). 

**• ERROR #40 BYTE OF BIT ADDRESS NOT IN BIT ADDRESSABLE DATA SEGMENT 

The symbol specified on the left hand side of the bit selector (.) is not segment 
type DATA, or not in a bit-addressable relocatable type segment. The numeric 
value is used if possible, but may cause other errors. (See errors 37 and 8.) 

••• ERROR #41 INVALID HARDWARE REGISTER 

The data address specified in the expression points to an unidentified location 
in the hardware register space (128 to 255). 

"• ERROR #42 BAD REGISTER BANK NUMBER 

The register bank number specified for the USING directive should be in the 
range of to 3. 

•■• ERROR #43 INVALID SIMPLE RELOCATABLE EXPRESSION 

Symbol definition directives such as EQU, SET, DATA, CODE, etc., require 
a simple relocatable expression (or a special register symbol in the EQU/SET 
case). See Chapter 2. 

• • • ERROR #44 INVALID RELOCATABLE EXPRESSION 

The relocatable expression specified violates the rules of relocatable expres- 
sions as given in Chapter 2. 
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••• ERROR #45 INPAGE RELOCATED SEGMENT OVERFLOW 

••' ERROR #46 INBLOCK RELOCATED SEGMENT OVERFLOW 

•" ERROR #47 BITADDRESSABLE RELOCATED SEGMENT OVERFLOW 

The repeatability of the current active segment specifies a limited segment 
size: INPAGE = maximum 256 bytes; INBLOCK = 2048 bytes; 
BITADDRESSABLE = 16 bytes. 

■ • • ERROR #48 ILLEGAL RELOCATION FOR SEGMENT TYPE 

The segment type and relocatability of the defined segment is an invalid com- 
bination. See Chapter 4 on segment definition directive. 



Macro Error Messages 

Error messages with numbers in the 300's indicate macro call/expansion errors. 
Macro errors are followed by a trace of the macro call/expansion stack — a series of 
lines which print out the nesting of macro calls, expansions, INCLUDE files, etc. 

Processing resumes in the original source file, with all INCLUDE files closed and 
macro calls terminated. 

■ • • ERROR #300 MORE ERRORS DETECTED, NOT REPORTED 

After 100 Macro or Control Errors on a given source line, this message is given 
and no more errors are reported for that line. Normal reporting resumes on the 
next source line. If the last error reported is a Macro Error, then this message 
will be issued. (See errors 16 and 400.) 

ERROR #301 UNDEFINED MACRO NAME 

The text following a metacharacter (%) is not a recognized user function name 
or built-in function. The reference is ignored and processing continues with the 
character following the name. 

ERROR #302 ILLEGAL EXIT MACRO 

The built-in macro "EXIT" is not valid in this context. The call is ignored. A 
call to "EXIT" must allow an exit through a user function, or the WHILE or 
REPEAT built-in functions. 

"• ERROR #303 FATAL SYSTEM ERROR 

Loss of hardware and/or software integrity was discovered by the macro 
processor. Contact Intel Corporation. 

"• ERROR #304 ILLEGAL EXPRESSION 

A numeric expression was required as a parameter to one of the built-in 
macros EVAL, IF, WHILE, REPEAT, and SUBSTR. The built-in function 
call is aborted, and processing continues with the character following the 
illegal expression. 

•*• ERROR #305 MISSING "Fl" IN "IF" 

The IF built-in function did not have a Fl terminator. The macro is processed, 
but may not be interpreted as you intended. 
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••• ERROR #306 MISSING "THEN" IN "IF" 

The IF built-in macro did not have a THEN clause following the conditional 
expression clause. The call to IF is aborted and processing continues at the 
point in the string at which the error was discovered. 

"• ERROR #307 ILLEGAL ATTEMPTTO REDEFINE MACRO 

It is illegal for a built-in function name or a parameter name to be redefined 
(with the DEFINE or MATCH built-ins). Also, a user function cannot be 
redefined inside an expansion of itself. 

ERROR #308 MISSING IDENTIFIER IN DEFINE PATTERN 

In DEFINE, the occurrence of "@ " indicated that an identifier type delimiter 
followed. It did not. The DEFINE is aborted and scanning continues from the 
point at which the error was detected. 

"• ERROR #309 MISSING BALANCED STRING 

A balanced string "(...)" in a call to a built-in function is not present. The 
macro function call is aborted and scanning continues from the point at which 
the error was detected. 

••• ERROR #310 MISSING LIST ITEM 

In a built-in function, an item in its argument list is missing. The macro func- 
tion call is aborted and scanning continues from the point at which the error 
was detected. 

•■• ERROR #311 MISSING DELIMITER 

A delimiter required by the scanning of a user-defined function is not present. 
The macro function call is aborted and scanning continues from the point at 
which the error was detected. 

This error can occur only if a user function is defined with a call pattern con- 
taining two adjacent delimiters. If the first delimiter is scanned, but is not 
immediately followed by the second, this error is reported. 

••• ERROR #312 PREMATURE EOF 

The end of the input file occurred while the call to the macro was being 
scanned. This usually occurs when. a delimiter to a macro call is omitted, caus- 
ing the macro processor to scan to the end of the file searching for the missing 
delimiter. 

Note that even if the closing delimiter of a macro call is given, if any preceding 
delimiters are not given, this error may occur, since the macro processor 
searches for delimiters one at a time. 

*•■ ERROR #313 DYNAMIC STORAGE (MACROS OR ARGUMENTS) OVERFLOW 

Either a macro argument is too long (possibly because of a missing delimiter), 
or not enough space is available because of the number and size of macro 
definitions. All pending and active macros and INCLUDE's are popped and 
scanning continues in the primary source file. Increase the mempercent 
parameter of the MACRO control to overcome this error. 
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ERROR #314 MACRO STACK OVERFLOW 

The macro context stack has overflowed. This stack is 64 deep and contains an 
entry for each of the following: 

1. Every currently active input file (primary source plus currently nested 
INCLUDE's). 

2. Every pending macro call, that is, all calls to macros whose arguments are 
still being scanned. 

3. Every active macro call, that is, all macros whose values or bodies are 
currently being read. Included in this category are various temporary 
strings used during the expansion of some built-in macro functions. 

The cause of this error is excessive recursion in macro calls, expansions, or 
INCLUDE's. All pending and active macros and INCLUDE's are popped and 
scanning continues in the primary source file. 



"• ERROR #315 INPUT STACK OVERFLOW 

The input stack is used in conjunction with the macro stack to save pointers to 
strings under analysis. The cause and recovery is the same as for the macro 
stack overflow. 



••■ ERROR #317 PATTERN TOO LONG 

An element of a pattern, an identifier or delimiter, is longer than 31 
characters, or the total pattern is longer than 255 characters. The DEFINE is 
aborted and scanning continues from the point at which the error was 
detected. 



"• ERROR #318 ILLEGAL METACHARACTER: ■■char" 

The METACHAR built-in function has specified a character that cannot 
legally be used as a metacharacter: a blank, letter, digit, left or right paren- 
thesis, or asterisk. The current metacharacter remains unchanged. 



ERROR #319 UNBALANCED ")" IN ARGUMENT TO USER DEFINED MACRO 

During the scan of a user-defined macro, the parenthesis count went negative, 
indicating an unmatched right parenthesis. The macro function call is aborted 
and scanning continues from the point at which the error was detected. 



ERROR #320 ILLEGAL ASCENDING CALL 

Ascending calls are not permitted in the macro language. If a call is not com- 
plete when the end of a macro expansion is encountered, this message is issued 
and the call is aborted. A macro call beginning inside the body of a user- 
defined or built-in macro was incompletely contained inside that body, 
possibly because of a missing delimiter for the macro call. 
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Control Error Messages 

Control error messages are issued when something is wrong with a control line in the 
source file. Command language errors, when they occur in the invocation line or in a 
primary control line, are fatal. However, the errors listed below are not considered 
fatal. (See INVOCATION LINE ERRORS, described above.) 

• •• ERROR #400 MORE ERRORS DETECTED. NOT REPORTED 

After 100 Macro or Control Errors on a given source line, this message is given 
and no more errors are reported for that line. Normal reporting resumes on the 
next source line. If the last error reported is a Control Error, then this message 
will be issued. (See errors 16 and 300.) 

■ " ERROR #401 BAD PARAMETER TO CONTROL 

What appears to be the parameter to a control is not correctly formed. This 
may be caused by the parameter missing a right parenthesis or if the paren- 
theses are not correctly nested. 

• ■ ' ERROR #402 MORE THAN ONE INCLUDE CONTROL ON A SINGLE LINE 

ASM51 allows a maximum of one INCLUDE control on a single line. If more 
than one appears on a line, only the first (leftmost) is included, the rest are 
ignored. 

"• ERROR #403 ILLEGAL CHARACTER IN COMMAND 

When scanning a command line, ASM51 encountered an invalid character. 

This error can be caused for a variety of reasons. The obvious one is that a 
command line was simply mistyped. The following example is somewhat less 
obvious: 

STITLECD-GO') 

The title parameter ends with the first right parenthesis, the one after the digit 
1. The title string is '"1". The next character "-" is illegal and will get error 
403. The next two characters, "GO", form a valid command (the abbreviation 
for GENONLY) which will cause the listing mode to be set. The final two 
characters "')" will each receive error 403. 



ERROR #407 UNRECOGNIZED CONTROL OR MISPLACED PRIMARY CONTROL: <control-name> 

The indicated control is not recognized as an ASM51 control in this context. It 
may be misspelled, mistyped, or incorrectly abbreviated. 

A misplaced primary control is a likely cause of this error. Primary control 
lines must be at the start of the source file, preceding all non-control lines 
(even comments and blank lines). 
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• ERROR #408 NO TITLE FOR TITLE CONTROL 

This error is issued if the title control has no parameter. The resulting title will 
be a string of blanks. 

■ ERROR #409 NO PARAMETER ALLOWED WITH ABOVE CONTROL 

The following controls do not have parameters: 

EJECT NOOBJECT NOMACRO 

SAVE NOPRINT PAGING 

RESTORE NOPAGING SYMBOLS 

LIST DEBUG NOSYMBOLS 

NOLIST NODEBUG XREF 

GENONLY NOERRORPRINT NOXREF 

GEN NOGEN 

If one is included, then this error will be issued, and the parameter will be 



• ERROR #410 SAVE STACK OVERFLOW 

The SAVE stack has a depth of eight. If the program tries to save more than 
eight levels, then this message will be printed. 

• ERROR #411 SAVE STACK UNDERFLOW 

If a RESTORE command is executed and there has been no corresponding 
SAVE command, then this error will be printed. 

• ERROR #413 PAGEWIDTH BELOW MINIMUM. SET TO 80 

The minimum pagewidth value is 80. If a pagewidth value less than 80 is given, 
80 becomes the new pagewidth. 

' ERROR #414 PAGELENGTH BELOW MINIMUM, SET TO 1 

The minimum number of printed lines per page is 10. If a value less than 10 is 
requested, 10 becomes the new pagelength. 

' ERROR #415 PAGEWIDTH ABOVE MAXIMUM, SET TO 132 

The maximum pagewidth value is 132. If a value greater than 132 is requested 
then, 132 becomes the new pagewidth. 



Special Assembler Error Messages 

Error messages in the 800's should never occur. If you get one of these error 
messages, please notify Intel Corporation via the Software Problem Report included 
with this manual. All of these errors are listed below: 

•" ERROR #800 UNRECOGNIZED ERROR MESSAGE NUMBER 

••• ERROR #801 SOURCE FILE READING UNSYNCHRONIZED 

•" ERROR #802 INTERMEDIATE FILE READING UNSYNCHRONIZED 

•" ERROR #803 BAD OPERAND STACK POP REQUEST 

**« ERROR #804 PARSE STACK UNDERFLOW 

••• ERROR #805 INVALID EXPRESSION STACK CONFIGURATION 



Assembler Output: Error Messages and Listing File Format 7-15 



Fatal Error Messages 

Errors numbered in the 900's are fatal errors. They are marked by the line 
FATAL ERROR 

preceding the message line. Assembly of the source code is halted. The remainder of 
the program is scanned and listed, but not assembled. 

"• ERROR #900 USER SYMBOL TABLE SPACE EXHAUSTED 

You must either eliminate some symbols from your program, or if you don't 
use macros, the NOMACRO control will free additional symbol table space. 

••• ERROR #901 PARSE STACK OVERFLOW 

"• ERROR #902 EXPRESSION STACK OVERFLOW 

This error will be given only for grammatical entities far beyond the complica- 
tion seen in normal programs. 

••• ERROR #903 INTERMEDIATE FILE BUFFER OVERFLOW 

This error indicates that a single source line has generated an excessive amount 
of information for pass 2 processing. In practical programs, the limit should 
be reached only for lines with a gigantic number of errors — correcting other 
errors should make this one go away. 

••* ERROR #904 USER NAME TABLE SPACE EXHAUSTED 

This error indicates that the sum of the number of characters used to define the 
symbols contained in a source file exceeds the macro processor's capacity. Use 
shorter symbol names, or reduce the number of symbols in the program. 



Assembler Listing File Format 

The MCS-51 assembler, unless overridden by controls, outputs two files: an object 
file and a listing file. The object file contains the machine code. The listing file contains 
a formatted copy of your source code with page headers and, if requested through 
controls (SYMBOL or XREF), a symbol table. Figure 7-1 shows an example of a 
listing file. 



MCS-51 MACRO ASSEMBLER SAMPLE mm/dd/yy 

system-id MCS-51 MACRO ASSEMBLER t Vx.y 
OBJECT MODULE PLACED IN SAM PI. OBJ 
ASSEMBLER INVOKED BY: ASM51 SAMP1.A51 DEBUG 



NAME SAMPLE 

EXTRN code (put_crlf, putstring, put_data_str, 
get_num) 

EXTRN code (binasc, ascbin) 
CSEG 



Figure 7-1. Example Listing File Format 
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25 


001A 


120000 


■ 




001D 


7800 




27 


001F 


: i ] Q : 1 1 


F 


28 


0022 


120000 


F 


29 








30 


0025 


900000 






002S 


120000 


_. 


32 


002B 


120000 




33 


002E 


7800 






0030 


120000 






0033 


120000 














0036 


7900 






0033 


120000 


1, 




003B 


7900 


1, 


fin 


003D 


120000 


*, 


41 








42 


0040 


E500 


1. 


a'a 


0042 


2500 






0044 


F500 


1, 


a* 








46 


0046 


7900 


F 


47 


0048 


120000 


F 


48 








49 


004B 


900000 


F 


50 


004E 


120000 


F 


51 


0051 


7900 


F 


52 


0053 


7A04 




53 


0055 


120000 


F 


54 


0058 


8 OBI 




55 








56 








57 


0008 






58 








59 








60 








61 








62 








63 








64 


0000 






65 


0004 






66 


0008 






67 








68 
69 


0000 


54595045 




70 


0004 


205E5820 






0003 


544F2052 






OOOC 


45545950 






0010 


45204120 






0014 


4E554D42 






0018 


4552 






001A 


00 







; This is the initializing section. Execution alwa 
ys 

; starts at address on power-up. 
ORG 

mov TMOD, S00100000B ; set timer mode to auto-rel 
oad 

mov TH1,#(-253J ; set timer for 110 BAUD 

mov SCON, S11011010B ; prepare the Serial Port 
setb TR1 ; start clock 

; This is the main program. It's an infinite loop, 
; where each iteration prompts the console for 2 
; input numbers and types out their sum. 
START: 

; type message explaining how to correct a typo 
mov DPTR, #typo_msg 
call putstring 
call put_crlf 

; get first number from console 

mov DPTR, #numl_msg 

call put_string 

call put_crlf 

mov R0 , Snuml 

call get_num 

call put_crl f 

; get second number from console 

mov DPTR, #num2_msg 

call put_string 

call put_crlf 

mov R0, #num2 

call get_num 

call put__crlf 

; convert the ASCII numbers to binary 
mov Rl, tnuml 
call ascbin 
mov Rl , #num2 
call ascbin 

; add the 2 numbers, and store the results in SUM 
mov a,numl 
add a , num2 
mov sum, a 

; convert SUM from binary to ASCII 
mov Rl,#sum 
call binasc 

; output sum to console 

aov DPTR, lsum_msg 

call put_string 

mov Rl,#sum 

mov R2 , # 4 

call putdata_str 

jmp start 

DSEG at 8 

STACK: ds 8 ; at power-up the stack pointer is 
; initialized to point here 



RSEG data_area 

NUM1: ds 4 

NUM2: ds 4 

SUM: ds 4 

RSEG constant_area 

TYPO_MSG: db 'TYPE -X TO RETYPE A NUMBER ' , 00H 



_ 



Figure 7-1. Example Listing File Format (Cont'd.) 
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S-51 MACRO ASSEMBLER 



001B 
0Q1F 
0023 
0027 
002B 
002F 
0031 
0032 
0036 
003A 
003E 
0042 
0046 
0049 
004A 
004E 
0052 
BOSS 



54595045 

20494E20 

46495253 

54204E55 

4D424552 

3A20 

00 

54595045 

20494E20 

5345434F 

4E44204E 

554D4245 

523A20 

00 

54484520 
53554D20 
495320 



SAMPLE 

KUM1 MSG: db 'TYPE IN FIRST NUMBER: 



NUM2_MSG: db 'TYPE IN SECOND NUMBER: 



SUM MSG: db 1 THE SUM IS ',0OH 



SYMBOL TABLE LISTING 



NAME 


T 


Y P E 


V A L U 


e 




ATTRIBUTE 


ASCBIN. . . . 


C 


A DDR 






EXT 




BINASC. . . . 


C 


A DDR 






EXT 




CONSTANT AREA 


C 


SEG 


0056H 






REL=UNIT 


DATA AREA . . 


□ 


SEG 


000CH 






RE L= UN IT 


GET NUM . . . 


C 


A DDR 






EXT 




NUM1 MSG. . . 


C 


A DDR 


001BH 


R 




SEG=CONSTANT AREA 


NUM1 


D 


A DDR 


COO0H 


R 




SEG=DATA AREA 


NUM2 MSG. . . 


C 


ADDR 


0032H 


B 




SEG=CONSTANT AREA 


NUM 2 


D 


A DDR 


0004H 


la 




S EG = D AT A_ARE A 


PUT CRLF. . . 


C 


ADDR 






EXT 




PUT_ D AT A_S T R . 


c 


ADDR 






EXT 




PUT STRING. . 


c 


ADDR 






EXT 




SAMPLE. . . . 














SCON 


D 


ADDR 


0098H 


A 






STACK .... 


D 


ADDR 


0008H 


A 






START .... 


C 


ADDR 


OOOBH 


A 






SUM MSG . . . 


C 


ADDR 


004AH 


B 




SEG=CONSTANT AREA 




D 


ADDR 


0008H 


B 




S E G= D AT A_ AR E A 




D 


ADDR 


008DH 


A 








D 


ADDR 


0089H 


A 








B 


ADDR 


0083H.6 


A 






TYP0_MSG. . . 


c 


ADDR 


OOOOH 


R 




SEG=CONSTANT AREA 



BANK (S) USED: 

COMPLETE, NO ERRORS FOUND 




Figure 7-1. Example Listing File Format (Cont'd.) 
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Listing File Heading 

Every page has a header on the first line. It contains the words "MCS-51 MACRO 
ASSEMBLER" followed by the title, if specified. If the title is not specified, then 
the module name is used. It is derived from the NAME directive (if specified), or 
from the root of the source filename. On the extreme right side of the header, the 
date (if specified) and the page number are printed. 

In addition to the normal header, the first page of listing includes a heading shown 
in figure 7-2. In it the assembler's version number is shown, the file name of the 
object file, if any, and the invocation line. The entire invocation line is displayed 
even if it extends over several lines. 



MCS-51 MACRO ASSEMBLER SAMPLE mm/dd/yy 

system-id MCS-51MACR0 ASSEMBLER. Vx.y 
OBJECTMODULE PLACED IN SAMP1.0BJ 
ASSEMBLER INVOKED BY: ASM51 SAMP1.A51 DEBUG 



Figure 7-2. Example Heading 

Source Listing 

The main body of the listing file is the formatted source listing. A section of for- 
matted source is shown in figure 7-3. 



LOC 


OBJ 


LINE 






1 






2 






3 






4 






5 






6 






7 


0000 




8 
9 


000 


758920 


10 


003 


758D03 


1 1 


0006 


7598DA 


1 2 


0009 


D28E 


13 






14 






1 5 






16 






17 






18 



NAME SAMPLE 



EXTRN 
EXTRN 



code 
code 



(put_c r I f 
(get_num, 



, put_string, put_data_ 
binasc, ascbin) 



st r) 



CSEG 

; This is the initializing section. Execution 
; always starts at address on power-up. 
ORG 



MOV TMOD, #001 00000B 
MOV TH1 ,#(-2 53 ) 
MOV SCON , #1 1 01 1 01 0B 
SETB TR1 



Set timer to auto-reload 
Set timer for 110 BAUD 
Prepare the Serial Port 
Start c lock 



18 START: 



This is the main program. It's an infinite loop, 
where each iteration prompts the console for 2 
input numbers and types out their sum. 











Figure 7-3. Example Source Listing 
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The format for each line in the listing file depends on the source line that appears on 
it. Instruction lines contain 4 fields. The name of each field and its meaning is shown 
in the list below: 

• LOC shows the location relative or absolute (code address) of the first byte of 
the instruction. The value is displayed in hexadecimal. 

• OBJ shows the actual machine code produced by the instruction, displayed in 
hexadecimal. 

• If the object that corresponds to the printed line is to be fixed up (it contains 
external references or is relocatable), an "F" is printed after the OBJ field. The 
object fields to be fixed up contain zeroes. 

• LINE shows the INCLUDE nesting level, if any, the number of source lines 
from the top of the program, and the macro nesting level, if any. All values in 
this field are displayed in decimal numbers. 

• SOURCE shows the source line as it appears in the file. This line may be 
extended onto the subsequent lines in the listing file. 

DB or DW directives are formatted similarly to instruction lines, except the OBJ 
field shows the data values placed in memory. All data values are shown. If the 
expression list is long, then it may take several lines in the listing file to display all of 
the values placed in memory. The extra lines will only contain the LOC and OBJ 
fields. 

The directives that affect the location counter without initializing memory (e.g., 
ORG, DBIT, or DS) do not use the OBJ field, but the new value of the location 
counter is shown in the LOC field. 

The SET and EQU directives do not have a LOC or OBJ field. In their place the 
assembler lists the value that the symbol is set to. If the symbol is defined to equal 
one of the registers, then 'REG' is placed in this field. The remainder of the directive 
line is formatted in the same way as the other directives. 

Format for Macros and INCLUDE Files 

The format for lines generated by a macro call varies with the macro listing mode 
(GEN, GENONLY, or NOGEN). Figure 7-4 shows the format of the call macro 
calls listed with each of these modes in effect. In all three calls the same instructions 
are encoded, the only difference is in the listing of the macro call. Note that the 
macro nesting level is shown immediately to the right of the line number. 

General control lines that appear in the source are interpreted by ASM5l's macrc 
processor and, as such, they are given a macro nesting level value. It is displayed 
immediately to the right of the line number. Lines added to the program as a result 
of the INCLUDE control are formatted just as if they appeared in the original 
source file, except that the INCLUDE nesting level is displayed immediately to the 
left of the line number. 

The control line shown below has both an INCLUDE nesting level and a macro 
nesting level. The INCLUDE nesting level is preceded by a equal sign '=', and the 
macro nesting level is preceded by a plus sign '+'. 

LOC OBJ LINE SOURCE 

=1 101 +1 $ SAVE NOLIST 

Symbol Table 

The symbol table is a list of all symbols defined in the program along with the status 
information about the symbol. Any predefined symbols used will also be listed in the 
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3 


+1 


SGEN 






4 




%addl6 (DPH, DPL, # (HIGH S) , 






5 


+1 








6 


+1 


%*DEFIKE(SUMLOW) (%PL 






7 


+2 


DPL, 






8 


+1 


% * DEFINE ( SUHHIGH) (%PH 






9 


+2 


DPH 






10 


+ 1 


MOV A,%XLOW 


0000 


E582 


11 


+2 


DPL 






12 


+1 


ADD A,%YLOW 


0002 


2402 


13 


+2 


#(LOW S) 






14 


+1 


MOV %SUMLOW 


0004 


F582 


15 


+2 


DPL, A 






16 


+1 


MOV A,%XHIGH 


0006 


E583 


17 


+2 


DPH 






18 


+1 


ADDC A, %YHIGH 


0008 


3400 


19 


+2 


#(HIGH S) 






20 


+ 1 


MOV %SUMHIGH 


O00A 


F583 


21 
22 
23 


+2 
+1 


DPH, A 






24 


+1 


SGENOIi LY 






25 


+ 1 








26 


+2 








27 


+2 




oooc 


E582 


28 


+2 


MOV A, DPL 


00OE 


240E 


29 


+2 


ADD A,#(LOW S) 


0010 


F582 


30 


+2 


MOV DPL, A 


0012 


E583 


31 


+2 


MOV A, DPH 


0014 
0016 


3400 


32 


+2 


ADDC A, » (HIGH $) 


F583 


33 
34 

35 


+ 2 
+1 


MOV DPH, A 






36 


+1 


SNOGEN 






37 




%addl6 (DPH, DPL, # (HIGH S), 






47 










48 




END 











Figure 7-4. Examples of Macro Listing Modes 



symbol table. If the XREF control is used, the symbol table will contain information 
about where the symbol was used in the program. Figure 7-5 shows a symbol table 
listing. 

The status information includes a NAME field, a TYPE field, a VALUE field, and 
an ATTRIBUTES field. 

The TYPE field specifies the type of the symbol: ADDR if it is a memory address, 
NUMB if it is a pure number (e.g., as defined by EQU), SEG if it is a relocatable 
segment, and REG if a register. For ADDR and SEG symbols, the segment type is 
added to the type: 

• C-CODE 

• D-DATA 

• X — XDATA 

• I - 1DATA 

• B-BIT 

The VALUE field shows the value of the symbol when the assembly was completed. 
For REG symbols, the name of the register is given. For NUMB and ADDR sym- 
bols, their absolute value (or if relocatable, their offset) is given, followed by A 
(absolute) or R (relocatable). For SEG symbols, the segment size is given here. Bit 
address and size are given by the byte part, a period (.), followed by the bit part. The 
scope attribute, if any, is PUB (public) or EXT (external). These are given after the 
VALUE field. 

For the module name symbol, the TYPE and the VALUE fields contain dashes 
(-— ). 
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N A H E 






V A L U 


E 




ATTRIBUTE 


ASCBIN. . . . 


C 


ADDR 







EXT 




BINASC. . . . 


c 


ADDR 






EXT 




CONSTANT AREA 


c 


SEG 


0056H 






REL-UNIT 


DATA AREA . . 


D 


SEG 


OOOCH 






REL-UNIT 


GET NUM . . . 


c 


ADDR 






EXT 




NUM1 MSG. . . 


c 


ADDR 


001BH 


s 




S EG=CONSTANT AREA 


NUM1 


D 


ADDR 


0000H 


R 




SEG=DATA AREA 


NUM2 MSG. . . 


c 


ADDR 


0032H 


R 




SEG=CONSTANT AREA 


NUM2 





ADDR 


0004H 


R 




S EG=DATA AREA 


PUT CRLF. . . 


c 


ADDR 






EXT 




PUT DATA STR. 


c 


ADDR 






EXT 




PUT STRING. . 


c 


ADDR 






EXT 




SAMPLE. . . . 
















D 


ADDR 


0098H 


A 






STACK .... 


D 


ADDR 


0008H 


A 






START .... 


C 


ADDR 


OOOBH 


A 






SUM MSG . . . 


C 


ADDR 


004AH 


R 




SEG=CONSTANT AREA 


SUM 


D 


ADDR 


0008H 


P. 




SEG=DATA_AREA 


TH1 


D 


ADDR 


008DH 


A 








D 


ADDR 


0089H 


A 








B ADDR 


0088H.6 


A 






TYPO_MSG . . . 


C 


ADDR 


OOOOH 


R 




S EG=CONSTANT_AREA 



REGISTER BANK (S) USED: 

ASSEMBLY COMPLETE, NO ERRORS FOUND 




Figure 7-5. Example Symbol Table Listing 



The ATTRIBUTES field contains an additional piece of information for some sym- 
bols: relocation type for segments, segment name for relocatable symbols. 

If the XREF control is used, then the symbol table listing will also contain all of the 
line numbers of each line of code that the symbol was used. If the value of the sym- 
bol was changed or defined on a line, then that line will have a hash mark (#) follow- 
ing it. The line numbers are displayed in decimal. 

If an inordinate number of symbol references are generated by your program, it may 
be impossible for the assembler to produce a complete XREF table for your entire 
program. In that event, the following warning message is issued at the head of the 
symbol table: 

••• WARNING, XREFS ABANDONED AT LINE Mine 

The XREF listing will be valid up to the specified line. 



Listing File Trailer 

At the end of the listing, the assembler skips two lines and prints a two-line message 
in the following format: 

[NO] REGISTER BANK(S) USED [: r r r r ], TARGET MACHINE(S): 8051 
ASSEMBLY COMPLETE, n ERRORS FOUND (I) 



Where r's are the numbers of the register banks used, and n and I are just like the 
console message. 



Assembly Language BNF Grammar 



This appendix contains a Backus-Naur Form (BNF) grammar for all of the MCS-51 
Assembly Language Constructions. It does not include the grammar for the macro facil- 
ity. (See Chapter 5 and Appendix F.) Although BNF grammar is designed to define only 
syntax, the metasymbols and language breakdown have been selected to show the seman- 
tics of the language. 

To simplify the grammar presented here, we have not defined all of the nuances of the 
language as rigorously as a complete BNF grammar would require. These exceptions are 
listed below. 

• There are two types of controls, primary and general. A control line containing 
a primary control must be the first line in a program, or only preceded by other 
control lines. 

• Some assembler directives may be used only while certain segment modes are in 
effect (e.g., the bit segment must be active when a DBIT directive is used). 

• Operator precedence in expressions has not been defined. 

• Symbol typing conventions are not identified. 

• In some of the definitions we have used a few words of description, contained in 
double quotes. 

• The ASCII string argument to the TITLE and DATE controls must either 
contain balanced parentheses or no parentheses at all. 

• There has been no attempt to show the logical blanks (spaces or tabs) that 
separate the fields on a line. 

• The symbol NULL is used to show that a meta-symbol may evaluate to nothing. 

• Except within character strings, ASM51 makes no distinction between upper 
and lower case characters. All terminal symbols have been shown in upper case, 
but you can use upper or lower case in your source code (including within hex 
constants). 

• The NAME statement may be preceded only by a control or empty lines. A 
comment line is considered an empty line. 

• List of terms, e.g., <expression list>, unless defined explicitly implies a 
sequence of items separated by commas (,). 

• Square brackets are used to enclose optional items. 
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<Assembly Language Program > 
^Statement Lisl> 
<End Statement> 
<Stalemenl> 

<Conlrol Line> 
<Conlrol Lisl> 
<Conlrol> 



<regbank > 
instruction Une> 
<Label> 

<Comment> 
<lnstruction> 



<Statement List> <End Statement 

<StatementxStatement Lisl> | NULL 

END <Comment> <CRLF> 

= <Controt Une> | instruction Line> | 
<Directive Line > 

- t <Controt List> <CRLF> 

= <ControlXControl List> | NULL 

- DATE(</1SCtfSrrtn9» | DM<ASCII Stringy) \ 
DEBUG | DE | 

NODEBUG | NODE | 
EJECT | EJ | 

ERRORPRINT(<f//e/iame» | EP«fifen»me» I ERRORPRINT | EP | 
NOERRORPRINT | NOEP | 
GENONLY | GO | 
NOGEN | NOGE | 
GEN | GE | 

INCLUDE«Fi/ename» | ICKFilename» | 
LIST | LI | 
NOLIST | NOLI | 

MACRO \{constant)\ | MR ]{<constant>)\ 
NOMACRO | NOMR | 

OBJECTKfi/enameX | OM<Filename» | OBJECT | OJ | 
NOOBJECT | NOOJ | 
PAGING | PI | 
NOPAGING | NOPI | 

PAGELENGTHKConsfanO) | PU<Constant>) | 
PAGEWIDTH«Cofislan(» | PVH<Constant» | 
PRINT«nVename>l I PR««/e™me» | PRINT | PR | 
NOPR1NT | NOPR | 

REGISTERBANKKregfian* list» | RB«rej6an* list» | 
NOREGISTERBANK | NORB | 
SAVE | SA | 
RESTORE | RS | 
SYMBOLS | SB | 
NOSYMBOLS | NOSB | 
mLE[<ASCIIString» | JJ«ASCII String >| | 
XREF | XR | 
NOXREF | NOXR 
■ | 1 | 2 | 3 

= <Label> <lnstruction> <Comment> <CRLF> 

- <Symbol Name>: I 
NULL 

- ,<ASCII Stringy | NULL 

= KArithmetic Instruction > | 
Multiplication tnstructiony \ 
KLogic Instruction > | 
<Data Move lnslruction> | 
<Jump Instruction > | 
<Subroutine lnstruction> | 
<Special Instruction > | 
NULL 
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Arithmetic Instruction > 
Arithmetic Mnemonic> 

Multiplication Instruction > 
<Logic Instruction > 

Accumulator Logic Instruction > 
<Data Address Logic Instruction > 

<Logic Mnemomo 
<Bit Logic lnstruction> 

<Data Move Instruction > 

<Bit Move lnstruction> 
<Byte Move Instruction > 

indirect Address Move> 

<Data Address Move> 
<Register Move> 

<External Move Instruction > 

<Code Move lnstruction> 

<Exchange Instruction > 

<Data Pointer Load > 
<Jump lnstruction> 



Arithmetic Mnemonio Accumulator>.<Byte Source> 

ADD | 
ADOC | 
SUBB 

DIV AB | 
MUL AB 

Accumulator Logic Instruction > \ 
<Data Address Logic Instruction > | 
<Bit Logic Instruction > 

<Logic Mnemomc> Accumulaior> .<Byte Source> 

<Logic Mnemomc> <Data Address >. Accumulator | 
<Logic Mnemonio <Data Address>. immediate Data> 

ANL | 
ORL | 
XRL 

ANLC.<3;/ Address > | 
ANL C. I <BitAddress> | 
ORL C.<8it Address > \ 
ORLC. KBit Address> 

<Bit Move lnstruction> | 
<Byte Move lnstruction> | 
<External Move lnstruction> | 
<Code Move Instruction > \ 
<Exchange Instruction > \ 
<Data Pointer Load> 

MOVC.<BitAddress> \ 
MOV <Bit Address > .C 

MOV Accumulator>.<Byte Source> \ 
Ondirect Address Move> \ 
■-.Data Address Move > | 
<Register Move> 

MOV <lndirect Address>.Accumulator> \ 
MOV <lndirect Address >. immediate Data > | 
MOV <lndirect Address >.<Data Address > 

MOV <Data Address> ,Accumulator> \ 
MOV <Data Address> .<8yte Source> 

MOV <Register>.Accumulator> | 
MOV <Register ^Immediate Data> \ 
MOV <Register>.<Data Address> \ 

MOVX Accumulator> .^Indirect Address> \ 
MOVX indirect Address> <Accumulator> | 
MOVX Accumulator> ,Si DPTR | 
MOVX (it DPTR, Accumulator > 

MOVC Accumulator, <it A + PC | 
MOVC Accumulator, ft A + DPTR 

XCHD Accumulator. indirect Address > | 
XCH Accumulator>,<Byte Destination> 

MOV DPTR. <lmmediate Data> 

<Decrement Jump> \ 
<CompareJump> | 
<TestJump> | 
Always Jump> 



A-4 MCS^-SI Macro Assembler 



<DecremenlJump> 
<Compare Jumpy 

<TeslJump> 



Always Jump > 



<Call Instruction > 

<Return Instruction > 
<Speclal Instructiony 



^Increment Instruction > 

<Decrement Instruction > 

Accumulator Modify Instruction > 
Accumulator Modify Mnemonic > 



<8it Modify Instruction > 
<Bit Modify Mnemonic> 



<Stack Instruction > 
<Directive Line> 



- DJNZ <Register> ,<Code Address> | 
DJNZ <Data Address >.<CodeAddress> 

: CJNE. Accumulatory,<lmmediate Data.<Code Address> | 
CJNE Accumulatory ,<Data Addressy ,<Code Addressy \ 
CJNE Klndirect Addressy ^Immediate Data>,<Code Address> | 
C J N E <Register> ^Immediate Data>. <Code Address > 

• JC <Code Address> | 
JNC <Code Addressy | 
JZ <Code Addressy | 
MZ<Code Addressy | 
JB <Bit Addressy. <Code Addressy | 
JBC <Bit Addressy, <Code Addressy | 
JNB <Bit Addressy, <Code Addressy 

' SMP<Code Addressy | 
AJMP <Code Address > | 
LJMP <Code Addressy | 
JHIP <Code Addressy | 
JMP eA + DPTR 

= <Call Instructiony | 
<Return Instruction y 

ACALL <Code Addressy | 
LCALL <Code Addressy | 
CALL <Code Address > 

: RET | 
RETI 

= increment Instructiony | 
<Decrement Instructiony | 
Accumulator Modify Instruction y | 
<Bit Modify Instruction > | 
<Stack Instructiony | 
NOP 

■ INC <Accumulalory | 
INCDPTR | 

INC <Byte Destinationy 



:= DEC <Accumulatory | 
DEC <Byte Destination y 

:= Accumulator Modify Mnemonicy Accumulatory 

CLR | 
CPL | 
DA | 
SWAP | 
RL | 
RR | 
RLC | 
RRC 

: := <Bit Modify Mnemonic > <Bit Destination > 

::- SETB | 
CLR | 
CPL 

::= POP <Data Address > | 
PUSH <Data Addressy 

::= <DirecliveStatementy<Commenty<CftLFy 
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<Direclive Statements 



<Org Statements 

<Using Statements 

<Symbol Definition Statements 



<Segment types 
<Relocatability> 

KExternal definition statements 
<external definitions 
<Usage types 

<Public definition statements 
<Name statements 
<Segment Select Statements 
<Absotute segment selects 
<Abs seg> 
<Base addresss 
<Relocatable segment select > 
<Space Allocation Statements 

<Memory Initialization Statements 



<Filename > 
<Directory name> 
<ASCIt Strings 
<Con slants 

<Decimal Digits 
<CRLF> 



:= <Org Statements \ 
<U$ing Statements 
<Symbol Definition Statements \ 
KSegment Select Statements | 
<Labefs<Space Allocation Statements | 
<Labels<Memory Initialization Statements 

:- ORG <ExpressionS 

:= USING <Expressionss 

:= <SymbolS EQU <ExpressionS \ 
<Symbols EQU <Symbol Registers \ 
<SymbolS SET <ExpressionS \ 
<Symbols SET <Symbol Registers | 
<$ymbols DATA <Expressions | 
<SymbolS XDATA <Expressions \ 
<Symbols BIT <Bit Addresss \ 

<Symbo/s CODE <expressions \ 
<Sym6o/> IDATA <expressions \ 

<Symbols SEGMENT <segment typess <relocatabilifyS \ 
<Extemal definition statements \ 
<Public definition statements \ 
<NAME statements \ 

> CODE | XDATA | IDATA | BIT | DATA 

:= UNIT | PAGE | INPAGE | INBLOCK | BIT ADDRESS ABLE | 
NULL 

:= EXTRN <Extemal definition lists 
:= <Usage types (<symbol lists) 
<Segment types | NUMBER 
:= PUBLIC <symbol lists 
:= NAME <symbolS 

= <absolute segment selects | Relocatable segment selects 

■= <ab$ segs <base addresss 

-- CSEG | DSEG | BSEG | XSEG | 1SEG 

:= AT KexpressionS | NULL 

:= RSEG <symbolS 

:= DS <Expression> \ 
DBIT <ExpressionS 

:= DB <Expression Lists 

"ASCII character strings, as items in a DB expression list. 

may be arbitrarily long." 
DW <Expression Lists 

"ASCII character strings, as items in a DW expression list, 

must be no more than two characters long." 
:= "Valid operating system filename" 
;= "Valid operating system directory name" 
:= "Any Printable ASCII Character" 

:= KDecimal Digits \ 

<Decimal Digits<ConstantS 

:= | 1 | 2 | 3 M I 5 I 6 | 7 | 8 | 9 

:= "ASCII Carriage Return Line Feed Pair" 
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(Byte Sourcey 



indirect Address> 

(Data Address> 
<lmmediate Oata> 
(Registery 

<Byle Destinaliony 

(Accumulatory 
<Symbol Registery 
(Symboly 
(Alphabet y 



<Special Char> 
Alphanumeric List> 
(Alphanumericy 

(Bit Destinationy 

<Bit Address> 

<Code Address> 
Expression Lisl> 

Expression > 



<Operator> 



<Number> 



- <lndireclAddress> | 
<Data Address> | 
immediate Data> | 
(Registery 

• J»R0 | If;. R1 | 
tt (Symboly 

■ (Expressiony 

' KExpressiony 

■= RO | R1 | R2 | R3 j R4 | R5 | R6 | R7 | 

<Symbol> 

:= indirect Address > | 
<DalaAddress> | 
(Registery 

A | <Symbol> 
:= <Accumulator> | <Register> 

<Alphabely<Alphanumeric Lisl> | <Special Char> Alphanumeric List> 
:= A | B | C | D | E | F | G | H .| I | 

J|K|L|M|N|0|P|Q|R| 

S|T|U|V|W|X|Y|Z 

a | b | c | d | e | f | 8 | h | ! | 
i I k | I | m | n | o | p | q | r | 
*-(* | u |» w|, | y | z | 

- Underscore" | 

? 

:= (Alphanumericy<Alphanumeric Listy | 
NULL 

:= <Alphabet> | 
(Decimal Digit> \ 
(Special Char> 

- C | 

<Bil Address> 

= <Expression> | 

<Expression>.<Expression> 
= <Expression> 

= <Expression> | 
(Expression >,<Expression Listy 

= <Symbol> | 
(Numbery | 

(Expression XOperalorxExpression > | 

{(Expression y) | 

+ (Expression > | 

-(Expression > j 

HIGH (Expression> | 

LOW <£>press/on> 

- + I - | / | MOD | SHL | SHR | 
EQ | = | NE | < > | LT | < | LE | 

<= I GT | > | GE | >- | AND | OR | XOR 
= (Hex Numbery | 
(Decimal Numbery \ 
(Octal N umber > \ 
(Binary Numbery 
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<Hex Number> 
<H0X Digit Stringy 

<HexDigity 

<Decimal Numbery 

<Decimal Digit String > 

<Octal Number > 

<Octal Digit String > 

<OctalOigit> 
<Binary Numbery 
<Binary Digit String> 

<Binary Digit > 



::= <Decimal Digity<Hex Digit Stringy H 

<Hex DigitxHex Digit Stringy | 
NULL 

::-0 |1 | 2 | 3 | 4 | 5 | 6 | 7 | 
8 | 9 |, A j B | C | I E ( F 

::- <Decimal Digit String y D | 
<Decimal Digit String > 

: KDecimai Digit > | 

<Decimal Digity<Decimal Digit String y 

::= <Octal Digit Stringy O | 
<Octat Digit String > O 

:- <Octal Digit y \ 

<Octal Digity<Octal Digit String y 

= |1 | 2 | 3 M | 5 | 6 | 7 

= <Bmary Digit Stringy B 

= <Binary Digity | 
<Binary Digity<Binary Digit String y 

-0 | 1 
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This appendix contains two tables (see tables B-l and B-2): the first identifies all of 
the 805 l's instructions in alphabetical order; the second table lists the instructions 
according to their hexadecimal opcodes and lists the assembly language instructions 
that produced that opcode. 

The alphabetical listing also includes documentation of the bit pattern, flags 
affected, number of machine cycles per execution and a description of the instruc- 
tions operation and function. The list below defines the conventions used to identify 
operation and bit patterns. 



Abbreviations and Notations Used 



A 


Accumulator 


AB 


Register Pair 


B 


Multiplication Register 


bit address 


8051 bit address 


page address 


11-bit code address within 2K page 


relative offset 


8-bit 2's complement offset 


C 


Carry Flag 


code address 


Absolute code address 


data 


Immediate data 


data address 


On-chip 8-bit RAM address 


DPTR 


Data pointer 


PC 


Program Counter 


Rr 


Register (r=0-7) 


SP 


Stack pointer 


high 


High order byte 


low 


Low order byte 


H 


Bits i through j 


,n 


Bit n 


aaa aaaaaaaa 


Absolute page address encoded in instruction and operand byte 


bbbbbbbb 


Bit address encoded in operand byte 


dddddddd 


Immediate data encoded in operand byte 


llllllll 


One byte of a 16-bit address encoded in operand byte 


mmmmmmmm 


Data address encoded in operand byte 


oooooooo 


Relative offset encoded in operand byte 


rorrrr 


Register identifier encoded in operand byte 


AND 


Logical AND 


NOT 


Logical complement 


OR 


Logical OR 


XOR 


Logical exclusive OR 


+ 


Plus 




Minus 


1 


Divide 




Multiply 


(X) 


The contents of X 


«x» 


The memory location addressed by (X) (The contents of X) 




Is equal to 


<> 


Is not equal to 


< 


Is less than 


> 


Is greater than 




Is replaced by 
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Table B-l. Instruction Set Summary 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


ACALL code addr 

(PC) - (PC) + 2 
(SP)-(SP) + 1 
((SP))-(PC)fow 
(SP) - (SP) + 1 
((SP))- (PC) ftigft 
(PC) 0-10 — page address 


2 


a a a 1 1 
aaaaaaaa 




Push PC on stack, 
and replace low 
order 11 bits with 
low order 11 bits of 
code address. 


ADD k.tdata 

(A) - (A) + data 




10 10 
dddddddd 


P OV AC C 


Add immediate 
data to A 


ADD A.fiRr 

(A) -(A) + «Rr)| 




1 1 1 r 


p ov ac c 


Add contents of 
indirect address to 
A 


ADD A.Rr 

(A) -(A) + (Rr> 


1 


OOlOlrri 


P OV AC C 


Add register to A 


ADD k.dataaddr 

(A) -(A) + {data address) 




10 10 1 
mmmmmmmm 


P OV AC C 


Add contents of 
data address to A 


ADDC A.fc/ate 

(A) - (A) + (C) + data 


1 


110 10 
dddddddd 


P OV AC C 


Add C and 
immediate data to 
A 


ADDC A.©Rr 

(A) -(A) + (C) + ((Rr)) 


1 


1 1 1 1 r 


P OV AC C 


Add C and contents 
of indirect address 
to A 


ADDC A.Rr 

(A) -(A) + (C) + (Rr) 




1 1 1 r r r 


P OV AC C 


Add C and register 
to A 


ADDC k.dataaddr 

(A) - (A) + (C) + (data address) 




110 10 1 
mmmmmmmm 


P OV AC c 


Add C and contents 
of data address to 
A 


AJMP code addr 

(PC) 0-10 ~ code address 


2 


a a a 1 
aaaaaaaa 




Replace low order 
11 bits of PC with 
low order 11 bits 
code address 


ANL A, Mate 

(A) — (A) AND date 


1 


10 10 10 
dddddddd 


p 


Logical AND 
immediate data to 
A 


ANL A.@Rr 

(A) — (A) AND ((Rr)) 


1 


1 1 1 1 r 


p 


Logical AND 
contents of indirect 
address to A 


ANL A.Rr 

(A) — (A) AND (Rr) 


1 


1 1 1 r r r 


p 


Logical AND 
register to A 


ANL k.dataaddr 

(A) - (A) AND (date address) 


1 


10 10 10 1 
mmmmmmmm 


p 


Logical AND 
contents of data 
address to A 


ANL Cbitaddr 

(C) -(C) AND (6/r address) 


2 


10 10 
bbbbbbbb 


c 


Logical AND bit to 

C 


ANL C.lbitaddr 

(C) - (C) AND NOT (6/1 address) 


2 


10 110 
bbbbbbbb 


c 


Logical AND 
complement of bit 
toC 


ANL data addr, tdata 

(data address) — 

{data address) kHDdata 


2 


10 10 11 
mmmmmmmm 
dddddddd 




Logical AND 
immediate data to 
contents of data 
address 


ANL data addr A 

[data address) - 

(data address) AND A 


1 


10 10 10 
mmmmmmmm 




Logical AND A to 
contents of data 
address 
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Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


CJNE iSiRr .tdata .code addr 
(PC) - (PC) + 3 
IF ((Rr))<> date 
THEN 

(PC) - (PC) + relative offset 
IF ((Rr))< date 
THEN (C)-1 
ELSE(C)-0 


2 


1 1 1 1 1 r 
dddddddd 

00000000 


c 


If immediate data 
and contents of 
indirect address 
are not equal, jump 
to code address 


CJNE A.ttdata .code addr 
(PC) - (PC) + 3 
IF (A) <> data 
THEN 

(PC) - (PCI + relative offset 
IF (A) < data 
THEN(C)~1 
ELSE (C) - 


2 


10 110 10 
dddddddd 

00000000 


c 


If immediate data 
and A are not 
equal, jump to code 
address 


CJNE A. data addr. code addr 
(PC) - (PC) + 3 
IF (A) < > {data address ) 
THEN 

(PC) - (PC) + relative offset 
IF (A) < [data address ) 
THEN (C) - ' 
BLSE(C)-0 


2 


10 110 10 1 
mmmmmmmm 

00000000 


c 


If contents of data 
address and A are 
not equal, jump to 
code address 


CJNE Rr Mdata code addr 
(PC) - (PC) + 3 
IF (Rr) < >data 
THEN 

(PC) - (PC) + relative offset 
IF (Rr)< date 
THENlCl-1 
ELSEICI-0 


2 


1 1 1 1 r r r 
dddddddd 
oooooooo 


c 


if immediate data 
and register are not 
equal, jump to code 
address 


CLR A 

(A)~0 


1 


1110 10 


p 


Set A to zero (0) 


CLR C 

(C)-0 




110 11 


c 


Set C to zero (0) 


CLR bit addr 

[bit address ) — 




110 10 
bbbbbbbb 




Set bit to zero (0) 


CPL A 

(A) - NOT (A) 




11110 10 


p 


Complements each 
bit in A 


CPL C 

(C) - NOT (C) 


t 


10 110 11 


c 


Complement C 


CPL bit addr 

{bit address ) ~ 

NOT {bit address) 




10 110 10 
bbbbbbbb 




Complement bit 


DA A 

(See description in Chapter 3) 




110 10 10 


P c 


Adjust A after a 
BCD add 


DEC (n Rr 

RRr))-((Br»-1 


1 


1 1 1 r 




Decrement 
contents of indirect 
address 


DEC A 

(A)-(A)-1 


1 


10 10 


p 


Decrement A 


DEC Rr 

(Rr)-(Rr)-1 




1 1 r r r 




Decrement register 


DEC data add, 

{data address) - 

{data address) - 1 




10 10 1 
mmmmmmmm 




Decrement 
contents of data 
address 


DIV AB 

(AB) — (A) 1 (B) 




1 1 


P ov c 


Divide A by B 

(multiplication 

register) 
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Table B-l. Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


DJNZ Rr.codeaddr 

(PC) - (PC) + 2 
(Br)- <«•)•»! 
IF(Rr)<>0 
THEN 

(PC) - (PC) + relative offset 


2 


1 1 1 1 r r r 

oooooooo 




Decrement 
register, if not zero 
(0), then jump to 
code address 


DJNZ data addr .code addr 
(PC) - (PC) + 3 
{data address) - 

{data address) - 1 
IF (data address ) <>0 
THEN 

(PC) - (PC) + relative offset 


2 


110 10 10 1 
mmmmmmmm 
oooooooo 




Decrement data 
address, if zero (0). 
then jump to code 
address 


INC @Rr 

t(Rr))-((Rr)) + 1 


1 


1 1 r 




Increment contents 
of indirect address 


INC A 

(A) -(A) + 1 


1 


10 


P 


Increment A 


INC DPTR 

(DPTR) — (DPTR) + 1 


1 


10 10 11 




Increment 16-bit 
data pointer 


INC Rr 

((R)-(Rr) + 1 


1 


1 r r r 




Increment register 


INC data addr 

(data address) - 

(data address) + 1 


2 


10 1 
mmmmmmmm 




Increment contents 
of data address 


JB bit addr. code addr 
(PC) - (PC) + 3 
IF (6/7 address)'-) 
THEN 

(PC) - (PC) + relative offset 


2 


10 
bbbbbbbb 
oooooooo 




If bit is one. n jump 
to code address 


JBC bit addr. code addr 
(PC) - (PC) + 3 
IF (6/7 address) = 1 
THEN 

(bit address) ~0 

(PC) — (PC) + relative offset 


2 


10 
bbbbbbbb 
oooooooo 




If bit is one. n clear 
bit and jump to 
code address 


JC code addr 

(PC) - (PC) + 2 

IF(C)>1 

THEN 

(PC) - (PC) + relative offset 


2 


10 
oooooooo 




If C is one. then 
jump to code 
address 


JMP c,A+DPTR 

(PC) -(A) + (DPTR) 


2 


1110 11 




Add A to data 
pointer and jump to 
that code address 


JNB bit addr .code addr 
(PC) -(PC) + 3 
IF (bit address)' 
THEN 

(PC) - (PC) + relative offset 


2 


110 
bbbbbbbb 
oooooooo 




If bit is zero, n jump 
to code address 


JNC code addr 

(PC) + (PC) + 2 

IF(C)-0 

THEN 

(PC) - (PC) + relative offset 


2 


10 10 
oooooooo 




If C is zero (0), n 
jump to code 
address 


JNZ code addr 

(PC) -(PC) + 2 

IF(A)<>0 

THEN 

(PC) - (PC) + relative offset 


2 


1110 
oooooooo 




If A is not zero (0). n 
jump to code 
address 
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Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


JZ codeaddr 

(PC) •- IPC) + 2 
IF(A) = 
THEN 

(PC) - (PC) + relative oltset 


2 


110 
00000000 




If A is zero (0). then 
lump to code 
address 


LCALL codeaddr 

(PC) -IPC) + 3 
(SP) - (SP) + 1 
((SP»-«PC))tow 
(SP) - (SP) + 1 
(ISP)) - [PC) high 
(PC) - code address 


2 


10 10 

Ill' 

I II' 




Push PC on stack 
and replace entire 
PC value with code 
address 


LJMP codeaddr 

(PC) — code address 


2 


10 

1 I I I I I I I' 
I I I I I I I I' 




Jump to code 
address 


MOV e Pr.ttdata 

((Fin) - data 


1 


1 1 1 1 1 r 
dddddddd 




Move immediate 
data to indirect 
address 


MOV SiPj-.A 

KRO)-(A) 


1 


1 1 1 1 1 1 r 




Move A to indirect 
address 


MOV in Rr.dataaddr 

IIFM) - [data address) 


2 


1 1 1 1 r 
mmmmmmmm 




Movecontents of 
data address to 
indirect address 


MOV k.tdata 

(A) *- data 


1 


1110 10 
dddddddd 


P 


Move immediate 
data to A 


MOV A,®Rf 

(A>-((RO> 


1 


1 1 1 1 1 r 


P 


Move contents of 
indirect address to 
A 


MOV A.Rr 

(A)-(Rr) 


1 


1 1 1 1 r r r 


P 


Move register to A 


MOV A.dataaddr 

(A) — (da/a address ) 


1 


1110 10 1 
mrnmmmmmm 


p 


Move contents of 
data address to A 


MOV Chit addr 

(C) - (6/7 address ] 




10100010 
bbbbbbbb 


(rj 


Mnuo hit In C 

IVIUVti Ull IU lj 


MOV DPTR. #da/a 

(DPTR) — t/a/a 


2 


1 1 
dddddddd 1 
dddddddd' 




Move two bytes of 
immediate data 
pointer 


MOV Rr.tdata 

[Pr)~data 


1 


1 1 1 1 r r r 
dddddddd 




Move Immediate 
data to register 


MOV Rr.A 

(Rr)-(A) 


1 


1 1 1 1 1 r r r 




Move A to register 


MOV Rr.dataaddr 

(Rr) - [data address) 


2 


1 1 1 r r r 
mmmmmmmm 




Move contents ol 
data address to 
register 


MOV bitaddr.C 

[bit address) - [O 


2 


10010010 
bbbbbbbb 




Move C to bit 


MOV data addr. Idata 

[data address i-data 




1110 10 1 
mmmmmmmm 
dddddddd 




Move immediate 
data to data 
address 


MOV data addr. f, Rr 

Wa/a address) - ((R/)) 


2 


1 1 1 r 
mmmmmmmm 




Move contents of 
indirect address to 
data address 


MOV data addr. A 

[data address ) — (A) 


1 


11110 10 1 
mmmmmmmm 




Move A to data 
address 


» The high order byte of the 16-bit operand is in the first byte following the opcode. The low order byte is 
in the second byte following the opcode. 



B-6 MCS -51 Macro Assembler 



Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


MOV dataaddr.Br 

(data address) — (Rr) 


2 


1 1 r r r 
mmmmmmmm 




Move register to 
data address 


MOV data addrl .data addr2 
{data addressl) - 

(data address?) 


2 


10 10 1 
mmmmmmmm' 
mmmmmmmm" 




Move contents ol 
second data 
address to first 
data address 


MOVC A,« A + DPTR 
(PC)-(PC)+1 
(A) — ((A) + (DPTR)) 


2 


1 1 1 1 


P 


Add A to DPTR and 
move contents of 
that code address 
with A 


MOVC A. ft A + PC 

(A) -{(A) + (PC)) 


2 


10 11 


P 


Add A to PC and 
move contents of 
that code address 
with A 


MOVX r„ DPTR. A 

KDPTRM -(A) 


2 


11110 




Move A to external 
data location 
addressed by 
DPTR 


MOVX ftRr.A 

MRU -(A) 


2 


1 1 1 1 1 r 




Move A to external 
data location 
addressed by 
register 


MOVX A. ft DPTR 

(A) -((DPTR)) 


2 


1110 


P 


Move contents ot 
external data loca- 
tion addressed by 
DPTR to A 


MOVX A. Rr 

(A)-((Rr|) 


2 


1 1 1 1 r 


P 


Move contents ot 
external data loca- 
tion addressed by 
register to A 


MUL AB 

(AB)-(Ar(B) 


A 


10 10 10 


P OV c 


Multiply A by B 
(multiplication 
register) 


NOP 


1 


00000000 




Do nothing 


ORL k.tdata 

(A) -(A) OR data 


1 


10 10 
dddddddd 


p 


Logical OR 
immediate data to 
A 


ORL A.ft Rr 

(A)-(A)OR((Rr)) 


1 


1 1 1 r 


p 


Logical OR 
contents of indirect 
address to A 


ORL A.Rr 

(A)-tA)OR(Rr) 


1 


1 1 r r r 


p 


Logical OR register 
to A 


ORL A.dataaddr 

(A) - (A) OR (data address) 


1 


1 1 1 
mmmmmmmm 


p 


Logical OR 
contents of data 
address to A 


ORL Cbitaddr 

(C)-(C) OR (61/ address) 


2 


1110 10 
bbbbbbbb 


c 


Logical OR bit to C 


ORL Clbitaddr 

(C) - (C) OR NOT (bit address ) 


2 


10 10 
bbbbbbbb 


c 


Logical OR 
complement of bit 
toC 


ORL data addr ,tdata 

(data address ) — 

(data address ) OR data 


2 


10 11 
mmmmmmmm 
dddddddd 




Logical OR 
immediate data to 
data address 


ORL data addr A 

(data address ) — 

(data address > OR A 


1 


10 10 
rnmmmmmmm 




Logical OR A to 
data address 


" The source data address (second data address) is encoded in the first byte following the opcode. The 
destination data address is encoded in the second byte following the opcode. 
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Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


POP data addr 

(data address ) - ((SP)) 
(SP)-(SP)-1 


2 


110 10 
mmmmmmmm 




Place top of stack 
at data address and 
decrement SP 


PUSH data addr 

(SP)-(SP) + 1 

{(SP)) — (data address) 


2 


110 
mmmmmmmm 




Increment SP and 
place contents of 
data address at top 
of stack 


RET 

(PC) high — ((SP)) 
(SP) - (SP) - 1 
(PC) low — ((SP)) 
(SP)-(SP)-1 


2 


1 1 




Return from 
subroutine call 


RETI 

(PC) high - ((SP)) 
(SP)-(SP)-1 
(PC) tow - ((SP)) 
(SP) - (SP) - 1 


2 


1 1 1 




Return from 
interrupt routine 


RL A 

(See description in Chapter 3) 


1 


10 1 1 




Rotate A left one 
position 


RLC A 

(See description in Chapter 3) 


1 


1 1 1 1 


P c 


Rotate A through C 
left one position 


RR A 

(See description in Chapter 3) 


1 


1 1 




Rotate A right one 
position 


RRC A 

(See description in Chapter 3) 


1 


1 1 1 


P c 


Rotate A through C 
right one position 


SETS C 

(C)-1 


1 


110 10 11 


c 


Set C to one (W 


SETB bit addr 

{bit address ) - 1 


1 


110 10 10 
bbbbbbbb 




Set bit to one (1) 


OJlvlr GUl/fcr aUUI 

(PC) - (PO + 2 

(PC) - (PC) + relative offset 


2 


1 
00000000 




Jump to code 
address 


SUBB A.ldata 

(A) -(A) -(e»-<*wa 


1 


10 10 10 
dddddddd 


P OV AC C 


Subtract immediate 
data from A 


SUBB A.aRr 

(A)-(A)-(C)-((FV|) 


1 


1 1 1 1 r 


P OV AC C 


Subtract contents 
of indirect address 
from A 


SUBB A,Rr 

<A)-(A)-(C)-(RO 


1 


1 1 1 r r r 


P OV AC C 


Subtract register 
from A 


SUBB A.dataaddr 

(A) - (A) - (C) - {data address) 


1 


10 10 10 1 
mmmmmmmm 


P OV AC C 


Subtract contents 
of data address 
from A 


SWAP A 

(See description in Chapter 3} 


1 


110 10 




Exchange low 
order nibble with 
high order nibble in 
A 


XCH A.tfrRr 

temp -((RO) 

((™ )) ^ (A) 

(A) — temp 


< 


1 1 1 1 r 


P 


Move A to indirect 
address and vice 
versa 


XCH A,Rr 

temp - (Rr) 

(Rf)— (A) 

(A) - temp 


1 


1 1 1 r r r 


P 


Move A to register 
and vice versa 


XCH A,dataaddr 

temp — (data address ) 
{data address) — (A) 
(A) - temp 


1 


110 10 1 
mmmmmmmm 


P 


Move A to data 
address and vice 
versa 
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Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


XCHD A.S.Rr 

temp -«rV))0-3 
((Rf )) 0-3 — (A) 0-3 
(A) 0-3 temp 


1 


1 1 1 1 1 r 


P 


Move low order of 
A to low order 
nibble oi indirect 
address and vice 
versa 


XRL A.tdata 

(Al - (A) XOR date 


1 


110 10 
dddddddd 


P 


Logical exclusive 
OR immediate data 
to A 


XRL A.S/ Ra 

(A) *- (A) XOR l(Hr» 


1 


1 1 1 1 r 


P 


Logical exclusive 
OR contents of 
indirect address to 


XRL A.Rr 

(A) - (A)XOR(Rr) 


1 


1 1 1 r r r 


P 


Logical exclusive 
OR register to A 


XRL k.dataaddr 

(A) - (A) XOR {data address) 


1 


110 10 1 
mmmmmmmm 


P 


Logical exclusive 
OR contents of data 
address to A 


XRL data addr .tdata 

{data address) - 

{data address) XOR data 


2 


110 11 
mmmmmmmm 
dddddddd 




Logical exclusive 
OR immediate data 
to data address 


XRL dataaddrA 

{data address I - 

{data address) XOR A 


1 


110 10 
mmmmmmmm 




Logical exclusive 
OR A to data 
address 
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Table B-2. Instruction Opcodes in Hexadecimal 



Hex 
Code 


Nu rnber 
of Bytes 


Mnemonic 


Operands 


00 


1 


NOP 




01 


2 


AJMP 


code addr 


02 


3 


LJMP 


code addr 


03 




RR 


A 


04 


1 


INC 


A 


05 




INC 


data addr 


06 




INC 


<ri RO 


07 


1 


INC 


(?£R1 


08 




INC 


R0 


09 




INC 


R1 


OA 


1 


INC 


R2 


0B 


1 


INC 


R3 


OC 


1 


INC 


R4 


0D 


1 


INC 


R5 


0E 


1 


INC 


R6 


OF 


1 


INC 


R7 


10 


3 


JBC 


bit addr .code addr 


11 


2 


ACALL 


code addr 


12 


3 


LCALL 


code addr 


13 




RRC 


A 


1 4 




DEC 


A 


15 




DEC 


data addr 


16 


1 


DEC 


@ R0 


17 


1 


DEC 


(it R1 


18 




DEC 


R0 


19 


1 


DEC 


R1 


1 A 




DEC 


R2 


1 B 




DEC 


R3 


1C 




DEC 


R4 


1 D 


1 


DEC 


R5 


1 E 




DEC 


R6 


1F 


1 


DEC 


R7 


20 




JB 


h/f aririr mrio aririr 


21 




AJMP 




22 




RET 




23 


1 


RL 


A 


24 




ADD 


A.#data 


25 




ADD 


A data addr 


26 


1 


ADD 


A. ,7/ R0 


27 


1 


ADD 


A,(« R1 


28 




ADD 


A.R0 


29 




ADD 


A R1 


2A 




ADD 


A.R2 


2B 


1 


ADD 


A.R3 


2C 




ADD 


A R4 


2D 


1 


ADD 


A R5 


2E 


1 


ADD 


A R6 


2F 


1 


ADD 


A R7 


30 




JNB 


Hit zxririr ztririr 


31 




ACALL 


LUUtf aUUi 


32 


1 


RETI 




33 




RLC 


A 


34 




ADDC 


A.ttdata 


35 




ADDC 


A. data addr 


36 




ADDC 


A,(>! R0 


37 




ADDC 


A,(S R1 


38 




ADDC 


A.R0 


39 




ADDC 


A,R1 


3A 




ADDC 


A.R2 


3B 




ADDC 


A,R3 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 



Hex 
Code 


Number 
of Bytes 


rVl 1 1 C 1 1 IU 1 IIV* 


Operands 


3C 


1 


ADDC 


A,R4 


3D 


1 


ADDC 


A,R5 


3E 


1 


ADDC 


A,R7 


3F 


1 


ADDC 


A,R7 


40 


2 


JC 


code addr 


41 


2 


AJMP 


code addr 


42 


2 


ORL 


data addr A 


43 


3 


ORL 


data addr.tdata 


44 


2 


ORL 


A.tdata 


45 


2 


ORL 


A.data addr 


46 


1 


ORL 


A.Si RO 


47 


1 


ORL 


A,@R1 


48 


1 


ORL 


A,R0 


49 


1 


ORL 


A,R1 


4A 


1 


ORL 


A.R2 


4B 


1 


ORL 


A.R3 


4C 


1 


ORL 


A,R4 


4D 


1 


ORL 


A.R5 


4E 


1 


ORL 


A.R6 


4F 


1 


ORL 


A,R7 


50 


2 


JNC 


code addr 


51 


2 


ACALL 


code addr 


52 


2 


ANL 


data addr, A 


53 


3 


ANL 


data add r.tdata 


54 


2 


ANL 


A.tdata 


55 


2 


ANL 


A. data addr 


56 


1 


ANL 


A.feRO 


57 


1 


ANL 


A, (u R1 


58 


1 


ANL 


A.RO 


59 


1 


ANL 


A.R1 


5A 


1 


ANL 


A.R2 


5B 


1 


ANL 


A,R3 


5C 


1 


ANL 


A,R4 


5D 


1 


ANL 


A.R5 


5E 


1 


ANL 


A.R6 


5F 


1 


ANL 


A.R7 


60 


2 


JZ 


code addr 


61 


2 


AJMP 


code addr 


62 


2 


XRL 


data addr, A 


63 


3 


XRL 


data addr, tdata 


64 


2 


XRL 


A.tdata 


65 


2 


XRL 


A. data addr 


66 


1 


XRL 


A,«i>R0 


67 


1 


XRL 


A,®R1 


68 


1 


XRL 


A.RO 


69 


1 


XRL 


A,R1 


6A 


1 


XRL 


A.R2 


6B 


1 


XRL 


A.R3 


6C 


1 


XRL 


A.R4 


6D 


1 


XRL 


A,R5 


6E 


1 


XRL 


A,R6 


6F 


1 


XRL 


A R7 


70 


2 


JNZ 


code addr 


71 


2 


ACALL 


code addr 


72 


2 


ORL 


C.bitaddr 


73 


1 


JMP 


@A+ DPTR 


74 


2 


MOV 


A.tdata 


75 


3 


MOV 


data addr, Idata 


76 


2 


MOV 


@R0, tdata 


77 


2 


MOV 


@>R1 .tdata 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 



Hex 
Code 


Number 
of Bytes 


Mnemonic 


Operands 


78 


2 


MOV 


RO.tdala 


79 


2 


MOV 


R1 .ttdata 


7A 


2 


MOV 


m.ttdata 


7B 


2 


MOV 


R3.#dafa 


7C 


2 


MOV 


R4,#dara 


7D 


2 


MOV 


RS.Hdata 


7E 


2 


MOV 


RS.ttdata 


7F 


2 


MOV 


R7, ttdata 


80 


2 


SJMP 


code addr 


81 


2 


AJMP 


code addr 


82 


2 


ANL 


CM addr 


83 


1 


MOVC 


A,<fiA + PC 


84 


1 


DIV 


AB 


85 


3 


MOV 


data addr .data addr 


86 


2 


MOV 


data addr M R0 


87 


2 


MOV 


data addr, @R1 


88 


2 


MOV 


data addr, R0 


89 


2 


MOV 


data addr , R1 


8A 


2 


MOV 


data addr. R2 


8B 


2 


MOV 


data addr. R3 


8C 


2 


MOV 


data addr Mi 


8D 


2 


MOV 


data addr.Rb 


8E 


2 


MOV 


data addr. Hi 


8F 


2 


MOV 


data addr, Rl 


90 


3 


MOV 


DPIR.ttdata 


91 


2 


ACALL 


code addr 


92 


2 


MOV 


bit addr. C 


93 


1 


MOVC 


A.ftA + DPTR 


91 


2 


SUBB 


A.Hdata 


95 


2 


SUBB 


A.dataaddr 


96 


1 


SUBB 


A,@R0 


97 


1 


SUBB 


A, is R1 


98 


1 


SUBB 


A,R0 


99 


1 


SUBB 


A.R1 


9A 


1 


SUBB 


A,R2 


9B 


1 


SUBB 


A.R3 


9C 


1 


SUBB 


A.R4 


9D 


1 


SUBB 


A.R5 


9E 


1 


SUBB 


A.R6 


9F 


1 


SUBB 


A.R7 


AO 


2 


ORL 


C,l bit addr 


A1 


2 


AJMP 


code addr 


A2 


2 


MOV 


C.bitaddr 


A3 


1 


INC 


DPTR 


A4 


1 


MUL 


AB 


A5 




reserved 




A6 


2 


MOV 


S RO.rtara addr 


A7 


2 


MOV 


@R1, data addr 


A8 


2 


MOV 


R0. data addr 


A9 


2 


MOV 


R1 .data addr 


AA 


2 


MOV 


R2. data addr 


AB 


2 


MOV 


RZ,data addr 


AC 


2 


MOV 


Rl.data addr 


AD 


2 


MOV 


RS.data addr 


AE 


2 


MOV 


Ri.dataaddr 


AF 


2 


MOV 


Rl, data addr 


BO 


2 


ANL 


C.I bit addr 


B1 


2 


ACALL 


code addr 


B2 


2 


CPL 


bit addr 


B3 


1 


CPL 


C 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 



Hex 
Code 


Number 
of Bytes 


1*1 11 cl 1 1 Ul 1 H. 




B4 


3 


CJNE 


AJdata .code addr 


B5 


3 


CJNE 


A.data addr, code addr 


B6 


3 


CJNE 


© HO.Uata .code addr 


B7 


3 


CJNE 


fit R1 .tdata .code addr 


B8 


3 


CJNE 


RO.tdata .code addr 


B9 


3 


CJNE 


R1 .tdata .code addr 


BA 


3 


CJNE 


m.tdata. code addr 


BB 


3 


CJNE 


R3.ttdata .code addr 


BC 


3 


CJNE 


R4 Mdata .code addr 


BD 


3 


CJNE 


RS.Hdata .code addr 


BE 


3 


CJNE 


RS.ttdata, code addr 


BF 


3 


CJNE 


R7. tdata. code addr 


CO 


2 


PUSH 


data addr 


CI 


2 


AJMP 


code addr 


C2 


2 


CLR 


bit addr 


C3 


1 


CLR 


C 


C4 


1 


SWAP 


A 


C5 




XCH 


A.dataaddr 


C6 


1 


XCH 


A.S/RO 


C7 


1 


XCH 


A.Cu R1 


C8 


1 


XCH 


A.RO 


C9 


1 


XCH 


A,R1 


CA 


1 


XCH 


A.R2 


CB 


1 


XCH 


A.R3 


CC 


1 


XCH 


A,R4 


CD 


1 


XCH 


A.R5 


CE 


1 


XCH 


A.R6 


CF 


1 


XCH 


A.R7 


DO 


2 


POP 


data addr 


D1 




ACALL 


code addr 


D2 




SETB 


bit addr 


D3 


1 


SETB 


C 


D4 


1 


DA 


A 


D5 




DJNZ 


data addr, code addr 


D6 


1 


XCHD 


A. «, RO 


D7 


1 


XCHD 


A.Cu R1 


D8 


2 


DJNZ 


RO.codeaddr 


D9 


2 


DJNZ 


FA .code addr 


DA 


2 


DJNZ 


R2.code addr 


DB 


2 


DJNZ 


Hi.code addr 


DC 


2 


DJNZ 


M.code addr 


DD 


2 


DJNZ 


RS.code addr 


DE 


2 


DJNZ 


H6.codeaddr 


DF 


2 


DJNZ 


R7 .code addr 


EO 


1 


MOVX 


A,@DPTR 


E1 


2 


AJMP 


code addr 


E2 


1 


MOVX 


A.e, RO 


E3 


1 


MOVX 


A. lf , R1 


E4 


1 


CLR 


A 


E5 




MOV 


A.dataaddr 


E6 


J 


MOV 


A.i„ RO 


E7 




MOV 


A fig R1 


E8 




MOV 


A.RO 


E9 




MOV 


A.R1 


EA 




MOV 


A.R2 


EB 




MOV 


A.R3 


EC 




MOV 


A,R4 


ED 




MOV 


A,R5 


EE 




MOV 


A,R6 


EF 




MOV 


A,R7 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 



Hex 
Code 


Number 
of Bytes 


Mnemonic 


Operands 


FO 


1 


MOVX 


@DPTR,A 


F1 


2 


ACALL 


code addr 


F2 


1 


MOVX 


@R0,A 


F3 


1 


MOVX 


@R1,A 


F4 


1 


CPL 


A 


F5 




MOV 


data addr A 


F6 




MOV 


@R0.A 


F7 


J 


MOV 


@R1.A 


F8 




MOV 


R0,A 


F9 




MOV 


R1.A 


FA 




MOV 


R2.A 


FB 




MOV 


R3.A 


FC 




MOV 


R4.A 


FD 




MOV 


R5,A 


FE 




MOV 


R6.A 


FF 




MOV 


R7.A 



Assembler Directive Summary 



Table C-l lists all the MCS-51 Macro Assembly Language directives. The format for 
each directive is shown along with a brief description of its operation. Complete 
descriptions of all directives are given in Chapter 4. 



Table C-l . Assembler Directives 



Directive 


Format 


Description 


BIT 


symbol name BIT bit address 


Defines a bit address in bil data space. 


BSEG 


BSEG | AT absolute address | 


Defines an absolute segmenl within the 
bit address space. 


CODE 


symbol name CODE expression 


Assigns a symbol name to a specific 
address in the code space. 


CSEG 


CSEG |AT absolute address\ 


Defines an absolute segmenl within the 
code address space- 


DATA 




Assigns a symbol name to a specific 
on-chip data address. 


DB 


[label ] DB expression list 


Generates a list ol byte values. 


DBIT 


[label ■ | DBIT expression 


Reserves a space in bil units in a BIT type 
segment. 


DS 


[label.] DS expression 


Reserves space in byte units; advances 
the location counter of the current 
segment. 


DSEG 


DSEG [AJabsolute address] 


Defines an absolute segment within the 
indirect internal data space 


DW 


[label:] DW expression list 


Generates a list of word values. 


END 


END 


Indicates end of program. 


EQU 


symbol name EQU expression 
or 

symbol name EQU special assembler symbol 


Set symbol value permanently. 






EXTRN 


EXTRN segment type {symbol names list) 


Defines symbols referenced in the 
current module that are defined in other 
modules. 


IDATA 


symbol name IDAT A expression 


Assigns a symbol name to a specific 
indirect internal address. 


1SEG 


ISEG [M absolute address] 


Defines an absolute segment within the 
internal data space. * 


NAME 


NAME module name 


Specifies the name of the current module. 


ORG 


ORG expression 


Sets the location counter of the current 
segment- 


PUBLIC 


PUBLIC list of names 


Identifies symbols which can be used 
outside the current module. 


RSEG 


RSEG segment name 


Selects a relocatable segment. 


SEGMENT 


symbol name SEGMENT segment type 
repeatability 


Defines a relocatable segment. 


SET 


symbol name SET expression 
or 

symbol _name SET special assembler symbol 


Sets symbol value temporarily. 
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Table C-l . Assembler Directives (Cont'd.) 



Directive 


Formal 


Description 


USING 


USING expression 


Sets the predefined symbolic register 
address and causes the assembler (o 
reserve space for the specified register 
bank. 


XDATA 


symbol name XDATA expression 


Assigns a symbol name to a specific 
off-chip data address. 


XSEG 


XSEG | AT absolute address ] 


Defines an absolute segment within the 
external data address space. 



Assembler Control Summary 




The table below (table D-l) contains all of the MCS-51 Macro assembler controls, 
their meaning, their defaults and their abbreviations. The table also defines whether 
the control is primary or general. (Primary controls must only appear at the head of 
the program or in the invocation lines; general controls may appear anywhere in the 
program.) 



Table D-l. Assembler Controls 



Name 


Primary ■ 
General 


Default 


Abbrev. 


Meaning 


UA 1 1 1 03 '&} 








Plarot ctrjnn in h&sarlor /Q rharartorc 
"IdVxCb aliiiiy 111 iiydUci \y Uf idi dUltf o 

maximum) 


ncui if 1 
UfctJUu 




INUUtBUu 




Outputs debug symbol information to 
object file 


NUUhbUu 






Symbol information not placed in 
object file 






Not Applicable 




Continue listing on next page 


ERRORPRINT[(F//.E)) 


P 


NOERRORPRINT 


EP 


Designates a file to receive error 
messages in addition to the listing file 
defaults to icoi 


NUhHHUHMHIN 1 


P 


NOEP 


Designates that error messages will be 
printed in listing tile only 


GEN 


G 


GENONLY 




Generates a full listing of the macro 
expansion process including macro 
calls in the listing file 


GENONLY 


G 


GO 


List only the fully expanded source as 
if all lines generated by a macro call 
were already in source file 


NOGEN 


G 


NOGE 


List only the original source text in 
listing file 


INCLUDE (FILE ) 


G 


Not Applicable 


IC 


Designates a file to be included as part 
of the program 


LIST 


G 


LIST 


LI 


Print subsequent lines of source in 
listing file 


NOLIST 


G 


NOLI 


Do not print subsequent lines of 
source in listing file 


MACRO[{mempercenf )] 


P 


MACRO(50) 


MR 


Evaluate and expand all macro calls. 
Allocate percentage of free memory 
for macro processing 


NOMACRO 


P 


NOMR 


Do not evaluate macro calls 


MOD51 


P 


MOD51 


MO 


Recognize the 8051-specific prede- 
fined special registers. 


NOMOD51 


P 


NOMO 


Do not recognize the 8051-specific 
predefined special registers. 
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Table D- 1 . Assembler Controls (Cont'd . ) 



Name 


Primary/ 
General 


Default 


Abbrev. 


Meaning 


0BJECT[(F7I.E)] 


P 


OBJECT(source.OBJ) 


OJ 


Designate file to receive object code 


NOOBJECT 


P 


NOOJ 


Designates that no object file will be 
created 


PAGING 


P 


PAGING 


PI 


Designates that listing will be broken into 
pages and each will have a header 


NOPAGING 


P 


NOPI 


Designates that listing will contain no page 


PAGELENGTH(n ) 


P 


PAGELENGTH(60) 


PL 


Sets maximum number of lines in each 
page of listing file (range = 10—65,535) 


PAGEWIDTH'n ) 


P 


PAGEWIDTH(120) 


PW 


Sets maximum number of characters in 
each line of listing file (range = 72 — 132) 


PRINT[(F/L£)] 


P 


PRINT(sourcaLST) 


PR 


Designates file to receive source listing 


NOPR1NT 


P 


NOPR 


Designates that no listing file will be 
created 


SAVE 


G 


Not Applicable 


SA 


Stores current control setting for LIST and 
GEN 


RESTORE 


G 


RS 


Restores control setting from SAVE stack 


REGISTERBANK(rt>....) 
rb - 0—3 


P 


REGISTERBANK(O) 


RB 


Indicates one or more banks used in 
program module 


NOREGISTERBANK 


P 


NORB 


Indicates that no banks are used 


SYMBOLS 


P 


SYMBOLS 


SB 


Creates a formatted table of all symbols 
used in program 


NOSYMBOLS 


P 


NOSB 


No symbol table created 


TITLE(sfNng) 


G 


TITLE( ) 


TT 


Places a string in all subsequent page 
headers (maximum 60 characters) 


XREF 


P 


NOXREF 


XR 


Creates a cross reference listing of all 
symbols used in program 


NOXREF 


P 


NOXR 


No cross reference list created 



MPL Built-in Functions 



The following is a list of all MPL built-in functions. 

%-textend-of-line of %'texf 
%{balanced-text) 

%-DEE\NE{call-pattern)\local-symbol-list\[macro-body) 

%'DEF\NE(macro-name\parameter-list]) [LOCAL local-list \ [macro-body) 

%n text-n-characters-long 

%EQS[arg1 ,arg2) 

% EVAUexpression ) 

%EXIT 

%GES[arg1 .arg2) 
%QTS[arg1 .arg2) 

%IF [expression] THEN [balanced-testn |ELSE [balanced-text2)\ Fl 
%IN 

%LEH[balanced-text) 
%LES[arg1 ,arg2) 
%nS[arg),arg2) 

%MAlCH{identifier1 delimiter identified) [balanced-text) 

%MEJACHAR[balanced-text) 

%HES[arg1 ,arg2) 

%OUHbalanced-text) 

%REPEAT [expression) [balanced-text) 

%SEJ[macro-id , expression ) 

%SUBSTR[balanced-text,expression1 ,expression2) 
%WHILE [expression) {balanced-text) 



Reserved Symbols 




The following is a list of all of the MCS-51 Macro Assembly Language reserved 
symbols. They can not be used as symbol names or for any other purpose in your 
program. 



Operators 


AND 


GT 


LOW 


NE 


SHL 


EQ 


HIGH 


LT 


NOT 


SHR 


GE 


LE 


MOD 


OR 


XOR 


Opcodes 


ACALL 


DEC 


JNC 


NOP 


RRC 


ADD 


DIV 


JNZ 


ORL 


SETB 


ADDC 


DJN2 


JZ 


POP 


SJMP 


AJMP 


INC 


LCALL 


PUSH 


SUBB 


ANL 


JB 


LJMP 


RET 


SWAP 


CJNE 


JBC 


MOV 


RETI 


XCH 


CLR 


JC 


MOVC 


RL 


XCHD 


CPL 


JMP 


MOVX 


RLC 


XRL 


DA 


JNB 


MUL 


RR 




Symbolic Register Addresses 


ARO 


AR2 


AR4 


AR6 




AR1 


AR3 


AR5 


AR7 




Directives 


BIT 


DB 


END 


NAME 


SET 


BSEG 


DBIT 


EQU 


ORG 


USING 


CODE 


DS 


EXTRN 


PUBLIC 


XDATA 


CSEG 


DSET 


IDATA 


RSEG 


XSEG 


DATA 


DW 


ISEG 


SEGMENT 




Operands 


•A 


EXTI1 


•PC 


RD 


TB8 


•AB 


FO 


PS 


REN 


TCON 


AC 


IE 


PSW 


RESET 


TFO 


ACC 


IE0 


PTO 


Rl 


TF1 


B 


IE1 


PT1 


RSO 


THO 


•c 


IP 


PXO 


RS1 


TH1 


CY 


INTO 


PX1 


RXD 


Tl 


DPH 


INT1 


•RO 


SBUF 


TIMERO 


DPL 


ITO 


•R1 


SCON 


TIMER1 


•DPTR 


IT1 


•R2 


SINT 


TLO 


EA 


OV 


•R3 


SMO 


TL1 


ES 


P 


•R4 


SM1 


TMOD 


ETO 


PO 


•R5 


SM2 


TRO 


ET1 


P1 


•R6 


SP 


TR1 


EXO 


P2 


*R7 


TO 


TXD 


EX1 


P3 


RB8 


T1 


WR 


EXTIO 


P4 









NOTE: 



Unstarred operands reserved only if using MOD51 . 



- 



Sample Program 



Figure G-l is a fully expanded listing file of an MCS-51 Macro Assembly Language 
program. This example includes three modules and their associated symbol table 
listings. 



. . , __ . 

MCS-51 MACRO ASSEMBLER SAMPLE mm/dd/yy 

Sysl»m-«1MCS-51MACR0 ASSEMBLER? Vxy 
OBJECT MODULE PLACED IN SAMP1.0BJ 
ASSEMBLER INVOKED BY: ASM51 SAM PI . A 51 DEBUG 



LOC 


OBJ 




LINE 


SOURCE 








1 


NAME SAMPLE 








2 
3 


! 

EXTRN code (put crlf, put string, put_data str, 










get nura) 








4 

5 


EXTRN code (binasc, ascbin) 









6 


; 

CSEG 








7 


; This is the initializing section. Execution alwa 








8 


ys 

; starts at address on power-up. 


0000 






9 


ORG 


0000 


758920 




10 


mov TMOD, #001000 00 B ; set timer mode to auto-rel 










oad 


0003 


75*003 




11 


mov THl,#(-253) ; set timer for 110 BAUD 


0006 


7598DA 






mov SCON, #11011010B ; prepare the Serial Port 


0009 


D28E 




a 


setb TR1 ; start clock 








14 

15 


; This is the main program. It's an infinite loop, 








16 


; where each iteration prompts the console for 2 








17 


; input numbers and types out their sum. 








18 


START: 








19 


; type message explaining how to correct a typo 


OOOB 


900000 


F 


20 


mov DPTR, #typo_msg 


OOOE 


120000 


F 


21 


call put_string 


0011 


120000 


F 


22 


call put_crlf 








23 


; get first number from console 


0014 


900000 


F 


24 


mov DPTR,#numl msg 


0017 


120000 


F 


25 


call put_string 


001A 


120000 


F 


26 


call put_crlf 


001D 


7800 


F 


27 


mov R0,#numl 


001F 


120000 


F 


28 


call get num. 


0022 


120000 


F 


29 


call put_crlf 








30 


; get second number from console 


0025 


900000 


F 


31 


mov DPTR, #num2 msg 


0028 


120000 


F 


32 


call put string 


002B 


120000 


F 


33 


call put_crlf 


002E 


7800 


F 


34 


mov R0,#num2 


0030 


120000 


F 


35 


call get_num 


0033 


120000 


F 


36 


call put_crlf 








37 


; convert the ASCII numbers to binary 


0036 


7900 


F 


38 


mov Rl, #numl 


0038 


120000 


F 


39 


call ascbin 


003B 


7900 


F 


40 


mov Rl,#num2 


003D 


120000 


F 


41 


call ascbin 








42 


; add the 2 numbers, and store the results in SUM 


0040 


E500 


F 


43 


mov a , numl 


0042 


2500 


F 


44 


add a , num2 


0044 


F500 


F 


45 


mov sum, a 








46 


; convert SUM from binary to ASCII 


0046 


7900 


F 


47 


mov Rl,#sum 




Figure G-1. Sample Relocatable Program 



G-2 MCS-51 Macro Assembler 



MCS-51 MACRO ASSEMBLER 



LOC 


OBJ 




LINE 


0048 


120000 


F 


48 








49 


004B 


900000 


F 


50 


004E 


120000 


F 


51 


0051 


7900 


F 


52 


0053 


7A04 




53 


0055 


120000 


F 


54 


0058 


80B1 




55 








56 








57 



0000 
0004 
0008 



0000 
0004 
0008 
0OOC 
0010 
0014 
0018 
001A 
001B 
001F 
0023 
0027 
002B 
002F 
0031 
0032 
0036 
003A 
003E 
0042 
0046 
0049 
004A 
004E 
0052 



54595045 

205E5820 

544F2052 

45545950 

45204120 

4E554D42 

4552 

00 

54595045 

20494E20 

46495253 

54204E55 

4D424552 

3A2 

00 

54595045 

20494E20 

5345434F 

4E44204E 

554D4245 

523A20 

00 

54484520 
53554D20 
495320 
00 



mm/dd/yy 



call binasc 

; output sum to console 

mov DPTR, #sum_msg 

call put_string 

mov Rl,#sum 

mov R2,#4 

call put_data_str 

jmp start 

DSEG at 8 
STACK: ds 8 



; at power-up the stack pointer is 
.■initialized to point here 



DATA_AREA segment DATA 

CONSTANTAREA segment CODE 

RSEG data_area 

NUMl: ds 4 

NUM2: ds 4 

SUM: ds 4 

RSEG constant_area 

TYPO MSG: db 'TYPE 'X TO RETYPE A NUMBER 1 



NUMl MSG: db 1 TYPE IN FIRST NUMBER: 



NUM2_MSG: db 1 TYPE IN SECOND NUMBER: ",00H 



SUM_MSG: db 'THE SUM IS *,00 



Figure G-1. Sample Relocatable Program (Cont'd.) 



I 



Sample Program G-3 




MCS-51 MACRO ASSEMBLER SAMPLE mm/M/yy 



SYMBOL TABLE LISTING 



NAME 


T 


Y P £ 


V A L U 


E 




ATTRIBUTE 


ASCBIN. . . . 


C 


ADDR 






EXT 




BINASC. . . . 


C 


ADDR 






EXT 




CONSTANT AREA 


C 


SEG 


0056H 






REL=UNIT 


DATA AREA . . 


D 


SEG 


OOOCH 






REL=UNIT 


GET NUM . . . 


C 


ADDR 






EXT 




NUM1 MSG. . . 


C 


ADDR 


001BH 


R 




SEG=CONSTANT AREA 


NUM1 


D 


ADDR 


OOOOH 


R 




SEG-DATA AREA 


NUM2 MSG. . . 


C 


ADDR 


0032H 


R 




SEG-CONSTANT AREA 


NUM2 


D 


ADDR 


0004H 


R 




SEG-DATAAREA 


PUT CRLF. . . 


c 


ADDR 






EXT 




PUT DATA STR. 


c 


ADDR 






EXT 




PUT STRING. . 


c 


ADDR 






EXT 




SAMPLE. . . . 
















D 


ADDR 


0098H 


A 






STACK .... 


D 


ADDR 


0008H 


A 






START .... 


c 


ADDR 


OOOBH 


A 






SUM MSG . . . 


c 


ADDR 


004AH 


R 




SEG-CONSTANT AREA 




D 


ADDR 


0008H 


R 




SEG=DATA_AREA 


TH1 


D 


ADDR 


008DH 


A 






D 


ADDR 


0089H 


A 








3 


ADDR 


0088H.6 


A 






TYPO_MSG. . . 


C 


ADDR 


OOOOH 


R 




SEG-CONSTANTAREA 



REGISTER BANK ( S ) USED: 

ASSEMBLY COMPLETE, NO ERRORS FOUND 




Figure G-1. Sample Relocatable Program (Cont'd.) 



G-4 MCS -51 Macro Assembler 




HCS-51 MACRO ASSEMBLER CONSOLE_IO mm/dd/yy 



system-id MCS-51MACR0 ASSEMBLER. Vx.y 
OBJECT MODULE PLACED IN SAMP2 . OBJ 
ASSEMBLER I NVOKED BY : ASM51 SAMP2 ■ A51 DEBUG 



NAME CONSOLE 10 



OOOD 
OOOA 
0000 A900 



IO_ROUTINES segment code 

RSEG IOROUTINES 
; This is the console IO routine cluster. 

PUBLIC put_crlf , put string, putdatastr, get 

_num 

USING 

This routine outputs a Carriage Return and 

a Line Feed 
PUT_CRLF : 
CR equ ODH 
LF equ OAH 

mov R1,00H 
d for restart 



; carriage return 
; line feed 

; RO value may be neede 



0002 740D 
0004 120000 
0007 740A 
0009 120000 
0O0C 22 



OOOD E4 
000E 93 
000F 6006 
0011 120000 

0014 A3 

0015 80F6 



0017 22 



0018 E7 

0019 120000 
001C 09 
001D DAF9 
001F 22 



mov A.lcr 
call put_char 
mov A.ttlf 
call put_char 
ret 

; This routine outputs a null-terminated string lo 
cated 

; in CODE memory, whose address is given in DPTR. 
PUT_STRING: 
clr A 

move A, GA+DPTR 
jz exit 
call putchar 
inc DPTR 
jmp put_string 
EXIT: 
ret 

; This routine outputs a string located in DATA me 
mory , 

; whose address is in Rl and its length in R2. 
PUT DATA_STR: 

mov A, SRI 

call put_char 

inc Rl 

djnz R2 , put_data_str 
ret 

; This routine outputs a single character to conso 
le. 

; The character is given in A. 
PUT_CHAR: 




Figure G-1. Sample Relocatable Program (Cont'd.) 



Sample Program G-5 















MCS-51 MACRO 


ASSEMBLER 


CONSOLE IO mm/dd/yy 






















LOC OBJ 


LINE 


SOURCE 








0020 3099FD 




46 


jnb TI,S 








0023 C299 




47 










0025 F599 




48 


mov S BUF , A 








0027 22 




49 














5 














51 


■ Thi routine a ts character strin f con 














^ e " g rom or,s 












52 


\ and stores it in memory at the address given i.n 














RO. 














} If a * X is rece ived , routine starts ove r aga in . 












54 


GET NUM: 








0028 7A04 




55 


nov R2 , t 4 ; set up string length 














as 4 








002A A900 




56 


iriov Rl, O0H j RO value may be neede 


























57 


GET LOOP: 








002C 120000 


F 


58 














59 


Next^^nstructions handle "X routine starts ov 














er if received 








002F C2E7 




6 


clr ACC. 7 ; clear the parity bit 








0031 B41905 




61 


c] ne A,#19H,G0 ON ; if not * X- go on 








0034 120000 


F 


62 


call put crlf 








0037 80EF 




e: 


imp get num 












64 


GO_ON. 








0039 F7 




6:> 


mov @R1 , A 








003A 09 






j DC ^ 








003B DAEF 




67 


djnz R2 , get loop 








003D 22 




6 3 


ret 












S3 














7 


; This routine gets a single character from consol 










71 


e . 

; The character is returned in A. 












72 


GET CHAR: 








003E 3098FD 




7 j 


j nb RI , $ 








0041 C298 




74 


clr RI 








0043 E599 




75 


mov A, SBUF 








0045 22 




7 6 


ret 












77 














78 


END 








MCS-51 MACRO 


ASSEMBLE 


Et 










SYMBOL TABLE 


LISTING 













NAME 


TYPE 




VALUE ATTRIBUTES 








ACC 


D ADDR 




00E0H A 








CONSOLE 10 . 














CR 


NUMB 




000DH A 








EXIT . . . . 


C ADDR 




00 17H R SEG=IO ROUTINES 








GET CHAR . . 


C ADDR 




003EH R SEG=IO ROUTINES 








GET LOOP . . 


C ADDR 




C02CH R SEG=IO~ROUTINES 








GET NUM. . . 


C ADDR 




(1MOU D diir err-To BrtTTTTMpc; 








GO ON. . . . 


C ADDR 




0039H R SEG=IO ROUTINES 








10 ROUTINES. 


C SEG 




0046H REL=UNIT 










NUMB 




000AH A 








PUT CHAR . . 


C ADDR 




0020H R SEG=IO ROUTINES 








PUT CRLF . . 


C ADDR 




OOO0H R PUB SEG=IO ROUTINES 








PUT DATA STR 


C ADDR 




0018H R PUB SEG=IO ROUTINES 








PUT STRING . 


C ADDR 




000DH R PUB SEG=IO ROUTINES 








RI 


B ADDR 




0098H.0 A 








SBUF . . . . 


D ADDR 




0099H A 










B ADDR 




0098H.1 A 






REGISTER BANK (S ) USED: C 








ASSEMBLY COMPLETE, NO 


E3 


.RORS FOUND 







Figure 6-1. Sample Relocatable Program (Cont'd.) 



-6 MCS®-51 Macro Assembler 



MCS-51 MACRO ASSEMBLER NUM_CONVERSION mm/dd/yy 

sysfem-<dMCS-51MACR0 ASSEMBLER. Vx.y 
OBJECT MODULE PLACED IN SAMP3. OBJ 
ASSEMBLER INVOKED BY: ASM51 SAMP3 . A51 DEBUG 

LOC OBJ LINE SOURCE 

1 NAME NUM CONVERSION 



0030 
0O2B 



0000 A801 



REG 

0002 08 

0003 E6 

0004 9430 

0005 75F064 
0009 A4 
OOOA FB 

OOOB 08 
OOOC E6 
OOOD 9430 
OOOF 75FO0A 
0012 A4 



3 NUM_ROUTINES segment CODE 

4 RSEG NUM_ROUTINES 

5 j This module handles conversion from ASCII to bin 
ary and back 

6 ; The binary numbers are signed one-byte integers, 

i.e. their 

7 j range is -123 to +127. The ASCII represantation 
is always 4 

8 ; characters long- i.e. a sign followed by 3 digit 
s. 

9 PUBLIC ascbin, binasc 

10 USING 

11 ZERO EQU '0' 

12 PLUS EQU ' + ' 

13 MINUS EQU 
14 

15 ; This routine converts ASCII to binary. 

16 ; INPUT- a 4 character string pointed at by Rl. T 
he number range 

17 f must be -128 to +127, and the string must hav 
e 3 digits 

18 ; preceded by a sign. 

19 ; OUTPUT- a signed one-byte integer, located where 

the input 

20 ; string started (pointed at by Rl) . 

21 ASCBIN: 

22 mov R0,001H ; Rl original value wi 
11 be needed later 

23 ; Compute first digit value, and store it temporar 
ily in TEMP 

24 TEMP equ R3 
2 5 inc R0 

26 mov A,@R0 

27 subb A, fzero 

28 mov B, 1 100 

2 9 mul AB 

3 mov TEMP , A 

31 ; Compute the second digit value 

3 2 inc R0 

33 mov A,@R0 

34 subb A, Izero 

35 mov B, #10 

3 6 mul AB 

37 ; Add the value of the second digit to num. 

38 add A, TEMP 

39 mov TEMP, A 

4 ; get third digit and its value to total 
4 1 inc R0 




Figure G-1. Sample Relocatable Program (Cont'd.) 



Sample Program G-7 



MCS-51 MACRO ASSEMBLER KUM CONVERSION 



mm/dd/yy 



LOC OBJ 

0016 E6 

0017 9430 
0019 2B 
001A FB 



001B E7 
001C B42D04 

001F EB 

0020 F4 

0021 04 

0022 FB 



0023 EB 

0024 F7 

0025 22 



0026 E7 

0027 772B 



0029 30E704 

002C 772D 

002E 14 

002F F4 



0030 09 

0031 75F064 

0034 84 

0035 2430 

0037 F7 

0038 09 

0039 E5F0 
0O3B 75F00A 
003E 84 
003F 2430 

0041 F7 

0042 E5F0 



42 
43 



89 
90 
91 



SOURCE 

mov A,@R0 
subb A, #zero 
add A, TEMP 
mov TEMP, A 

; test the sign, and complement the value if it's 
negative 

mov A,@R1 

cjne A, #minus,pos ;s)cip the next 4 instruct 

ions if positive 
mov A, TEMP 
Cpl A 
inc A 
mov TEMP , A 

; epilogue- store the result and exit 
pos : 

mov A, TEMP 

mov @R1 , A 

ret 

; This routine converts binary to ASCII. 
; INPUT- a signed one-byte integer, pointed at by 
Rl. 

; OUTPUT- a signed one-byte integer 

; OUTPUT- a 4 character string, located where the 

input number 

; was (pointed at by Rl) . 
BINASC: 

SIGN bit ACC.7 

; Get the number, find its sign and store its sign 
mov A,@R1 

mov 6Rl,#plus ;store a plus sign (over- 

written 

.* by minus if needed) 

jnb sign,go_on2 ;test the sign bit 

; Next 3 instructions handle negative numbers 

mov @Rl,*(minus ;store a minus sign 

dec A 

cpl A 

; Factor out the first digit 
GO ON2: 



mc 
mov 
div 
add 
mov 



Rl 

B, #100 



A, fzero 

@R1,A ;store the first digit 

Factor out the second digit 
inc Rl 
mov A,B 

B, #10 



div 
add 
mov 



A3 



, fzero 
?R1,A 

; Store the third digit 
A,B 



.•store the second digit 



Figure G-1. Sample Relocatable Program (Cont'd.) 



G-8 MCS®-51 Macro Assembler 



NUM_CONVERSION 



mm/dcs/yy 



0044 2430 92 add A,#Zero 

0046 F7 93 mov @Rl,A ;store the third digit 

94 ; note that we return without restoring Rl 

0047 22 95 ret 



MCS-51 MACRO ASSEMBLER NUM CONVERSION 



SYMBOL TABLE LISTING 



NAME TYPE VALUE ATTRIBUTES 

ACC D ADDR 0OEOH A 

ASCBIN . . . . C ADDR 0OOOH R PUB SEG=NUM_ROUTINES 

B D ADDR 0OF0H A 

BINASC .... C ADDR 0026H R PUB SEG=NUM_ROUTINES 

GO_ON2 .... C ADDR 0030H R SEG=NUM_ROUTINES 

MINUS NUMB 002DH A 

NUM_CONVERSION 

NUM_ROUTINES . C SEG 0048H REL=UNIT 

PLUS NUMB 002BH A 

POS C ADDR 0023H R SEG=NUM_ROUTINES 

SIGN B ADDR 00E0H.7 A 

TEMP REG R3 

ZERO NUMB 0030H A 



REGISTER BANK ( S ) USED: 

ASSEMBLY COMPLETE, NO ERRORS FOUND 




Figure G-1. Sample Relocatable Program (Cont'd.) 







Reference Tables 



This appendix contains the following general reference tables: 

• ASCII codes 

• Powers of two 

• Powers of 16 (in base 10) 

• Powers of 10 (in base 16) 

• Hexadecimal-decimal integer conversion 



ASCII Codes 



The 8051 uses the 7-bit ASCII code, with the high-order 8th bit (parity bit) always 
reset. 



GRAPHIC OR 


ASCII 


CONTROL 


(HEXADECIMAL) 


NUL 


00 


SOH 


01 


STX 


02 


ETX 


03 


EOT 


04 


ENQ 


05 


ACK 


06 


BEL 


07 


BS 


08 


HT 


09 


LF 


OA 


VT 


0B 


FF 


OC 


CR 


0D 


SO 


0E 


SI 


OF 


DLE 


10 


DC1 (XON) 


1 1 


DC2 ITAPEI 


12 


DC3 (X OFFI 


13 


DC4 ITAPLI 


14 


MAK 


15 


SYN 


16 


ETB 


17 


CAN 


18 


EM 


19 


SUB 


1A 


ESC 


IB 


FS 


1C 


GS 


ID 


RS 


IE 


US 


IF 


SP 


20 




21 




22 


a 


23 


s 


24 


% 


25 


& 


26 




27 


( 


28 




29 




2A 



GRAPHIC OR ASCII 
CONTROL (HEXADECIMAL) 



+ 


2B 




2C 




2D 




2E 


1 


2F 





30 


1 


31 


2 


32 


3 


33 


4 


34 


5 


35 


6 


36 


7 


37 


8 


38 


9 


39 




3A 




3B 


< 


3C 




3D 




3E 




3F 




40 


A 


41 


e 


42 


C 


43 


D 


44 


E 


45 


F 


46 


G 


47 


H 


48 




49 


J 


4A 


K 


4B 


L 


4C 


M 


4D 


N 


4E 





4F 


P 


50 


□ 


51 


R 


52 


S 


53 


T 


54 


U 


55 



GRAPHIC OR 


ASCII 


CONTROL (HEXADECIMAL) 


V 


56 


W 


67 




58 


Y 


69 


Z 


5A 


1 


5B 




5C 




5D 


All) 


5E 


- M 


5F 




60 


a 


61 
62 




63 


il 


64 


I 


65 
66 


S 


67 


h 


68 




69 




6A 


k 


6B 




6C 




6D 




6E 


o 


6F 


P 


70 


n 


71 


■ 
t 


73 
74 




75 




76 




77 




78 


V 


79 




7A 




7B 


1 


7C 


', (ALT MODE) 


7D 




7E 


DEL (RUB OUT) 


7F 



H-2 MCS®-51 Macro Assembler 



POWERS OF TWO 













2 


n 


2 






















1 





1 






















2 


1 


05 






















4 


2 


25 






















8 


3 


126 






















16 


4 


0062 


5 




















32 


5 


0.031 


25 




















64 


6 


015 


625 




















128 


7 


007 


812 


5 


















256 


8 


003 


906 


25 


















512 


9 


0.001 


953 


125 
















1 


024 


10 


000 


976 


562 


5 














2 


048 


i i 


000 


488 


281 


25 














4 


096 


12 


000 


244 


140 


625 














8 


192 


13 


000 


122 


070 


312 


5 












16 384 


14 


000 


061 


035 


156 


25 












32 768 


15 


000 


030 


517 


578 


125 












65 


536 


16 


000 


015 


258 


789 


062 


5 










131 


072 


1 7 


000 


007 


629 


394 


531 


25 










262 


144 


18 


000 


003 


814 


697 


265 


625 










524 


288 


19 


000 


001 


907 


348 


632 


812 








1 


048 


576 


20 


000 


000 


953 


674 


316 


406 








2 


097 


1 52 


21 


000 


000 


476 


83 7 


158 


203 








4 


194 


304 


22 


000 


000 


238 


418 


579 


101 








8 


388 


608 


23 


000 


000 


119 


209 


289 


550 








16 


777 


216 


2 d 


000 


000 


059 


604 


644 


7 75 








33 


554 


432 


25 


000 


000 


029 


802 


322 


387 








67 


108 


864 


?6 


000 


000 


1 4 


901 


1 6 1 


1 93 








134 


217 


7 28 


27 


000 


000 


007 


450 


580 


596 








268 


435 


4 56 


28 


000 


000 


003 


725 


290 


298 








536 


870 


91 2 


29 


000 


000 


001 


862 


645 


149 






1 


073 


741 


824 


30 


000 


000 


000 


931 


322 


574 






2 


147 


483 


648 


31 


000 


000 


000 


465 


661 


28 7 






4 


294 


96 7 


296 


32 


000 


000 


000 


232 


830 


643 






8 


589 


934 


592 


33 


000 


000 


000 


1 16 


415 


321 






17 


1 79 


869 


184 


34 


000 


000 


000 


058 


207 


660 






34 


359 


738 


368 


35 


000 


000 


000 


029 


103 


830 






68 


719 


476 


736 


36 


000 


000 


000 


014 


551 


915 






137 


438 


963 


472 


37 


000 


000 


000 


007 


275 


957 






274 


877 


906 


944 


38 


000 


000 


000 


003 


637 


978 






549 


755 


813 


888 


39 


000 


000 


000 


001 


818 


989 




1 


099 


51 1 


627 


776 


4 G 


oooo 


000 


000 


000 


909 


494 




2 


199 


023 


255 


552 


41 


000 000 


000 


000 


454 


747 




4 


398 


046 


51 l 


104 


42 


000 


000 


000 


000 


227 


373 




8 


796 


093 


022 


208 


43 


000 


000 


000 


000 


113 


686 




17 


592 


186 


044 


416 


44 


000 


000 


000 


000 


056 


843 




35 


184 


372 


088 


832 


45 


000 


000 


000 


000 


028 


421 




70 


368 


744 


177 


664 


46 


000 


000 


000 


000 


014 


210 




140 


737 


488 


355 


328 


47 


000 


000 


ooo 


000 


007 


105 




281 


474 


976 


710 


656 


48 


000 


000 


000 


000 


003 


552 




562 


949 


953 


421 


312 


49 


000 


000 


000 


000 


001 


7 76 


1 


125 


899 


906 


842 


624 


50 


000 


000 


000 


000 


000 


888 


2 


251 


799 


813 


685 


248 


51 


000 


000 


000 


000 


000 


444 


4 


503 


599 


627 


370 


496 


52 


000 


000 


000 


000 


000 


222 


9 


007 


199 


254 


740 


992 


53 


000 


000 


000 


000 


000 


1 1 1 


18 


014 


398 


609 


481 


984 


54 


000 


000 


000 


000 


000 


055 


36 


028 


797 


018 


963 


968 


55 


000 


000 


000 


000 


000 


027 


72 


057 


594 


037 


927 


936 


56 


000 


000 


000 


000 


000 


013 


144 


115 


188 


075 


865 


872 


57 


000 


000 


000 


000 


000 


006 


288 


230 


376 


151 


71 1 


744 


58 


000 


000 


000 


000 


000 


003 


576 


460 


752 


303 


423 


488 


59 


000 


000 


000 


000 


000 


001 


1 152 


921 


504 


606 


846 


976 


60 


000 


000 


000 


000 


000 


000 


2 305 


843 


009 


213 


693 


952 


61 


000 


000 


000 


000 


000 


000 


4 611 


686 


018 


427 


387 


904 


62 


000 000 


000 


000 


000 


000 


9 223 


372 


036 


854 


775 


808 


63 


000 000 


000 


000 


000 


000 



s 

25 
125 
56 2 5 
781 25 

390 625 
695 312 5 
84 7 656 25 
923 828 125 

461 914 062 5 

230 957 031 25 
615 478 515 625 
307 739 257 812 5 

653 869 628 906 25 
826 934 814 453 125 
913 467 407 226 562 5 
456 733 703 613 281 25 

228 366 861 806 640 625 
614 183 425 903 320 312 5 
807 091 712 951 660 156 25 
403 545 866 475 830 078 125 



701 


772 


928 


237 


915 


039 


062 


5 
















350 


886 


464 


118 


957 


519 


531 


25 
















675 


443 


232 


059 


478 


759 


765 


625 
















837 


721 


616 


029 


739 


379 


882 


812 


5 














418 


860 


808 


014 


869 


689 


941 


406 


25 














709 


430 


404 


007 


434 


844 


970 


703 


125 














854 


715 


202 


003 


717 


422 


485 


351 


562 


5 












427 


357 


601 


001 


858 


711 


242 


675 


781 


25 












713 


678 


800 


500 


929 


355 


621 


337 


890 


626 












356 


839 


400 


250 


464 


677 


810 


668 


945 


312 


5 










1 78 


419 


700 


125 


232 


338 


905 


334 


472 


656 


25 










089 


209 


850 


062 


616 


169 


452 


667 


236 


328 


125 










044 


604 


925 


031 


308 


084 


726 


333 


618 


164 


062 


5 








022 


302 


462 


515 


654 


042 


363 


166 


809 


082 


031 


25 








51 1 


151 


231 


257 


827 


021 


181 


583 


404 


541 


015 


626 








755 


575 


615 


628 


913 


510 


590 


791 


702 


270 


507 


812 


5 






877 


787 


807 


814 


456 


755 


295 


395 


851 


135 


253 


906 


25 






938 


893 


903 


907 


228 


377 


647 


697 


926 


567 


676 


950 


125 






469 


446 


951 


953 


614 


188 


823 


848 


962 


783 


813 


4 76 


562 


5 




734 


723 


475 


976 


807 


094 


411 


924 


481 


391 


906 


738 


281 


25 




867 


361 


737 


988 


403 


64 7 


205 


962 


240 


695 


953 


369 


140 


625 




433 


680 


868 


994 


201 


773 


602 


981 


120 


34 7 


976 


684 


570 


312 


5 


216 


840 


434 


497 


100 


886 


801 


490 


560 


173 


988 


342 


285 


156 


25 


108 


420 


217 


248 


550 


443 


400 


745 


280 


086 


994 


171 


142 


578 


125 



Reference Tables H-3 



POWERS OF 16 (IN BASE 10) 











16" 


n 






16 


n 














1 





0.10000 


00000 


00000 


00000 


X 


10 










16 


i 


0.62500 


00000 


00000 


00000 


X 


10 1 










256 


2 


0.39062 


50000 


00000 


00000 


X 


10 2 








4 


096 


3 


0.24414 


06250 


00000 


00000 


X 


10 5 








65 


536 


4 


0.15258 


78906 


25000 


00000 


X 


10 






1 


048 


576 


5 


0.95367 


43164 


06250 


00000 


X 


10 






16 


777 


216 


6 


0.59604 


64477 


53906 


25000 


X 


10 






268 


435 


456 


7 


037252 


90298 


46191 


40625 


X 


10* 8 




4 


294 


967 


296 


8 


0.23283 


06436 


53869 


62891 


X 


10 




68 


719 


476 


736 


9 


0.14551 


91522 


83668 


51807 


X 


10"'° 


1 


099 


511 


627 


776 


10 


90949 


47017 


72928 


23792 


X 


io-' 2 


17 


592 


186 


044 


416 


11 


56843 


41886 


08080 


14870 


X 


10~ 13 


281 


474 


976 


710 


656 


12 


0.35527 


13678 


80050 


09294 


X 


io-' 4 


503 


599 


627 


370 


496 


13 


22204 


46049 


25031 


30808 


X 


IO" 15 


057 


594 


037 


927 


936 


14 


13877 


78780 


78144 


56755 


X 


10"' 6 


921 


504 


606 


846 


976 


15 


0.86736 


17379 


88403 


54721 


X 


KT" 













POWERS OF 10 (IN BASE 16) 












10 n 


n 




10 


n 














1 





1 .0000 


0000 


0000 


0000 












A 


i 


1999 


9999 


9999 


999 A 












64 


2 


28F5 


C28F 


5C28 


F5C3 


X 


IB' 1 








3E8 


3 


4189 


374B 


C6A7 


EF9E 


X 


16 J 








2710 


4 


0.68DB 


8BAC 


710C 


B296 


X 


16 






1 


86 AO 


5 


0.A7C5 


AC47 


1B47 


8423 


X 


16 - 






F 


4240 


6 


10C6 


F7A0 


B5ED 


8D37 


X 


16 " 4 






98 


9680 


7 


0.1 AD7 


F29A 


BCAF 


4858 


X 


16" s 






5F5 


E100 


8 


0.2AF3 


1DC4 


6118 


73BF 


X 


16~ 6 






3B9A 


CAOO 


9 


0.44B8 


2FA0 


9B5A 


52CC 


X 


16" 1 




2 


540B 


E400 


10 


0.6DF3 


7F67 


SEF6 


EADF 


X 


16" 8 




17 


4876 


E800 


11 


AFEB 


FFOB 


CB24 


AAFF 


X 


16" 9 




E8 


D4A5 


1000 


12 


0.1197 


9981 


2DEA 


1119 


X 


16- 9 




918 


4E72 


AOOO 


13 


1C25 


C268 


4976 


81 C2 


X 


16" 10 




5AF3 


107A 


4000 


14 


0.2D09 


370D 


4257 


3604 


X 


16"" 


3 


8D7E 


A4C6 


8000 


15 


0480E 


BE7B 


9D58 


566D 


X 


16 12 


23 


8652 


6FC1 


0000 


16 


734A 


CA5F 


6226 


FOAE 


X 


16" 13 


163 


4578 


5D8A 


0000 


17 


0.B877 


AA32 


36 A4 


B449 


X 


16" 14 


DEO 


B6B3 


A764 


0000 


18 


0.1272 


5DD1 


D243 


ABA1 


X 


16-' 4 


8AC7 


2304 


89E8 


0000 


19 


1D83 


C94F 


B6D2 


AC35 


X 


16-' 5 



n 


*# MLa o i Macro AssemDier 
























HEXADECIMAL-DECIMAL INTEGER CONVERSION 










The ta 


ble below provides for 


direct conversions between hexadecimi 


I integers in the 


range 0-FFF and decimal integers in the 


range 


)-4095. For conversion of larger integers, the table values may be added to the following figures: 
















Hexadecimal 


Decimal 


nexaaecimai 


rtarimal 
LFBCImai 




















01 000 


4 096 


20 000 


131 072 




















02 000 


8 192 


30 000 


1 96 608 




















03 000 


12 288 


40 000 


262 144 




















04 000 


16 384 


50 000 


327 680 




















06 000 


20 480 


60 000 


393 216 




















06 000 


24 576 


70 000 


458 752 




















07 000 


28 672 


80 000 


524 288 




















08 000 


32 768 


90 000 


589 824 




















09 000 


36 864 


AO 000 


655 360 




















OA 000 


40 960 


80 000 


720 896 




















0B 000 


45 056 


CO 000 


786 432 




















0C 000 


49 152 


DO 000 


851 968 




















0D 000 


53 248 


E0 000 


917 504 




















0E 000 


57 344 


F0 000 


983 040 




















OF 000 


61 440 


1 00 000 


1 048 576 




















10 000 


65 536 


200 000 


2 097 152 




















11 000 


69 632 


300 000 


3 145 728 




















12 000 


73 728 


400 000 


4 194 304 




















13 000 


77 824 


500 000 


5 242 880 




















14 000 


81 920 


600 000 


6 291 456 




















1 £ nnn 
I o uuu 


86 016 


700 000 


7 340 032 




















16 000 


90 1 12 


800 000 


8 388 608 




















17 000 


94 208 


900 000 


9 437 184 




















18 000 


98 304 


A00 000 


10 485 760 




















19 000 


102 400 


BOO 000 


1 1 534 336 




















1 A 000 


106 496 


COO 000 


12 582 912 




















1 B 000 


1 1 n rqo 


rinn nnn 
uuu uuu 


1 T K"J 1 /!Qfl 
1 J DJ 1 ^00 




















1 C 000 


114 688 


E00 000 


14 680 064 




















1 D 000 


1 18 784 


F00 000 


15 728 640 




















1E 000 


122 880 


1 000 000 


16 777 216 




















IF 000 


126 976 


2 000 000 


33 554 4 32 















1 


2 


3 


4 5 


6 7 


8 9 


A B 


C 


D 


E 


F 


000 


0000 


0001 


uuuz 


0003 


0004 0005 


UUUO UUU / 


Anno aaao 
uuuo uuuy 


on i a nni 1 

UU I U UU I I 


00 1 2 


0013 


0014 


0015 


010 


001 6 


001 7 


001 8 


001 9 


UU20 OU2 1 


aat) Ann 


UU/h UU^t) 


uuzo uuz / 


0028 


0029 


0030 


0031 


020 


0032 


0033 


0034 


0035 


0036 0037 


0038 0039 


0040 0041 


0042 0043 


0044 


0045 


0046 


0047 


UJU 


0048 


0049 


0050 


0051 


0052 0053 


0054 0055 


0056 0057 


0058 0059 


0060 


0061 


0062 


0063 


040 


UUO** 


rwm 


UUOD 


0067 


0068 0069 


UU / U UU / l 


A.n.7'? AA7T 
UU / £. UU / o 


UU / H uu / o 


0076 


0077 


0078 


0079 


050 


no. fin 


0081 


00,0.9 


0083 


0084 0085 


UUOD uuo/ 


aaoq nnftQ 

UUOD UUOU 


aaqa, nnpi 

UUUU UU3 I 


0092 


0093 


0094 


0095 


060 


0096 


0097 


0098 


0099 


0100 0101 


0102 0103 


0104 0105 


0106 0107 


0108 


0109 


0110 


0111 


u/ u 


0112 


0113 


0114 


0115 


0116 0117 


0118 0119 


0120 0121 


0122 0123 


0124 


0125 


0126 


0127 


080 


0128 


0129 


0130 


0131 


0132 0133 


0134 0135 


0136 0137 


0138 0139 


0140 


0141 


0142 


0143 


090 


0144 


0145 


0146 


0147 


0148 0149 


0150 0151 


0152 0153 


0154 0155 


0156 


0157 


0158 


0159 


0A0 


0160 


0161 


0162 


0163 


0164 0165 


0166 0167 


0168 0169 


0170 0171 


0172 


0173 


0174 


0175 


UDU 


0176 


0177 


0178 


0179 


0180 0181 


0182 0183 


0184 0185 


0186 0187 


0188 


0189 


0190 


0191 


oco 


0192 


0193 


0194 


0195 


0196 0197 


0198 0199 


0200 0201 


0202 0203 


0204 


0205 


0206 


0207 


0D0 


0208 


0209 


0210 


0211 


0212 0213 


0214 0215 


0216 0217 


0218 0219 


0220 


0221 


0222 


0223 


OEO 


0224 


0225 


0226 


0227 


0228 0229 


0230 0231 


0232 0233 


0234 0235 


0236 


0237 


0238 


0239 


OFO 


0240 


0241 


0242 


0243 


0244 0245 


0246 0247 


0248 0249 


0250 0251 


0252 


0253 


0254 


0255 



Reference Tables H-5 



HEXADECIMAL-DECIMAL INTEGER CONVERSION (Cont'd) 







u 


1 


* 


m 

J 


4 







7 


o 
o 


o 

y 


A 

A 


O 

D 




Q 




F 


10 





0256 


0257 


0258 


0259 


0260 


0261 


0262 


0263 


0264 


0265 


0266 


0267 


0268 


0269 


0270 


0271 


11 





0272 


0273 


0274 


0275 


0276 


0277 


0278 


0279 


0280 


0281 


0282 


0283 


0284 


0285 


0286 


0287 


12 





0288 


0289 


0290 


0291 


0292 


0293 


0294 


0295 


0296 


0297 


0298 


0299 


0300 


0301 


0302 


0303 


13 





0304 


0305 


0306 


0307 


0308 


0309 


0310 


0311 


0312 


0313 


0314 


0315 


0316 


0317 


0318 


0319 


14 





0320 


0321 


0322 


0323 


0324 


0325 


0326 


0327 


0328 


0329 


0330 


0331 


0331 


0333 


0334 


0335 


15 





0336 


0337 


0338 


0339 


0340 


UOH 1 


0342 


0343 


0344 


0345 


0346 


0347 


0348 


0349 


0350 


0351 


160 


0352 


0353 


0354 


0355 


0356 


0357 


0358 


0359 


0360 


0361 


0362 


0363 


0364 


0365 


0366 


0367 


:: 


9 


0368 


0369 


0370 


0371 


0372 


0373 


0374 


0375 


0376 


0377 


0378 


0379 


0380 


0381 


0382 


0383 






0384 


0385 


0386 


0387 


0388 


0389 


0390 


0391 


0392 


0393 


0394 


0395 


0396 


0397 


0398 


0399 


190 


0400 


0401 


0402 


0403 


0404 


0405 


0406 


0407 


0408 


0409 


0410 


041 1 


0412 


0413 


0414 


0415 


1A0 


0416 


0417 


0418 


0419 


0420 


0421 


0422 


0423 


0424 


0425 


0426 


0427 


0428 


0429 


0430 


0431 


1B0 


0432 


0433 


0434 


0435 


0436 


0437 


0438 


0439 


0440 


0441 


0442 


0443 


0444 


0445 


0446 


0447 


1C0 


0448 


0449 


0450 


0451 


0452 


0453 


0454 


0455 


0456 


0457 


0458 


0459 


0460 


0461 


0462 


0463 


1D0 


0464 


0465 


0466 


0467 


0468 


0469 


0470 


0471 


0472 


0473 


0474 


0475 


0476 


0477 


0478 


0479 


1E0 


0480 


0481 


0482 


0483 


0484 


0485 


0486 


0487 


0488 


0489 


0490 


0491 


0492 


0493 


0494 


0495 


1F0 


0496 


0497 


0498 


0499 


0500 


0501 


0502 


0503 


0504 


0505 


0506 


0507 


0508 


0509 


0510 


0511 


200 


0512 


0513 


0514 


0515 


0516 


0517 


0518 


0519 


0520 


0521 


0522 


0523 


0524 


0525 


0526 


0527 


210 


0528 


0529 


0530 


0531 


0532 


0533 


0534 


0535 


0536 


0537 


0538 


0539 


0540 


0541 


0542 


0543 


220 


0544 


0545 


0546 


0547 


0548 


0549 


0550 


0551 


0552 


0553 


0554 


0555 


0556 


0557 


0558 


0559 


230 


0560 


0561 


0562 


0563 


0564 


0565 


0566 


0567 


0568 


0569 


0570 


0571 


0572 


0573 


0574 


0575 


240 


0576 


0577 


0578 


0579 


0580 


0581 


0582 


0583 


0584 


0585 


0586 


0587 


0588 


0589 


0590 


0591 


250 


0592 


0593 


0594 


0595 


0596 


0597 


0598 


0599 


0600 


0601 


0602 


0603 


0604 


0605 


0606 


0607 


260 


0608 


0609 


0610 


0611 


0612 


0613 


0614 


0615 


0616 


0617 


0618 


0619 


0620 


0621 


0622 


0623 


270 


0624 


0625 


0626 


0627 


0628 


0629 


0630 


0631 


0632 


0633 


0634 


0635 


0636 


0637 


0638 


0639 


280 


0640 


0641 


0642 


0643 


0644 


0645 


0646 


0647 


0648 


0649 


0650 


0651 


0652 


0653 


0654 


0655 


290 


0656 


0657 


0658 




UuDU 


fuse i 
UOO I 


0662 


UOO J 


UOO** 


UOOD 


UOOO 


0667 


0668 


0669 


0670 


067 1 


2A0 


0672 


0673 


0674 


0675 


0676 


0677 


0678 


0679 


0680 


0681 


0682 


0683 


0684 


0685 


0686 


0687 


2B0 


0688 


0689 


0690 


0691 


0692 


0693 


0694 


0695 


0696 


0697 


0698 


0699 


0700 


0701 


0702 


0703 


2C0 


0704 


0705 


0706 


0707 


0708 


0709 


0710 


071 1 


0712 


0713 


0714 


0715 


0716 


0717 


0718 


0719 


2D0 


0720 


0721 


0722 


0723 


0724 


0725 


0726 


0727 


0728 


0729 


0730 


0731 


0732 


0733 


0734 


0735 


2E0 


0736 


0737 


0738 


0739 


0740 


0741 


0742 


0743 


0744 


0745 


0746 


0747 


0748 


0749 


0750 


0751 


2F0 


0752 


0753 


0754 


0755 


0756 


0757 


0758 


0759 


0760 


0761 


0762 


0763 


0764 


0765 


0766 


0767 


300 


0768 


0769 


0770 


0771 


0772 


0773 


0774 


0775 


0776 


0777 


0778 


0779 


0780 


0781 


0782 


0783 


310 


0784 


0785 


0786 


0787 


0788 


C17QQ 


u/»u 


n7Qi 


0792 


0793 


0794 


0795 


0796 


0797 


0798 


0799 


320 


0800 


0301 


0802 


0803 


0804 


0805 


0806 


0807 


0808 


0809 


0810 


0811 


0812 


0813 


0814 


0815 


330 


0816 


0817 


0818 


0819 


0820 


0821 


0822 


0823 


0824 


0825 


0826 


0827 


0828 


0829 


0830 


0831 


340 


0832 


0833 


0834 


0835 


0836 


0837 


0838 


0839 


0840 


0841 


0842 


0843 


0844 


0845 


0846 


0847 


350 


0848 


DA4Q 


UODU 


UOO 1 


HQ CO 


UO Do 




UOOD 


0856 


0857 


0858 


0859 


0860 


0861 


0862 


0863 


360 


0864 


0865 


0866 


0867 


0868 


0869 


0870 


0871 


0872 


0873 


0874 


0875 


0876 


0877 


0878 


0879 


370 


0880 


0881 


0882 


0883 


0884 


0885 


0886 


0887 


0888 


0889 


0890 


0891 


0892 


0893 


0894 


0895 


380 


0896 


0897 


0898 


0899 


0900 


0901 


0902 


0903 


0904 


0905 


0906 


0907 


0908 


0909 


0910 


0911 


390 


0212 


0913 


0914 


0915 


0916 


0917 


0918 


0919 


0920 


0921 


0922 


0923 


0924 


0925 


0926 


0927 


3A0 


0928 


0929 


0930 


0931 


0932 


0933 


0934 


0935 


0936 


0937 


0938 


0939 


0940 


0941 


0942 


0943 


3B0 


0944 


0945 


0946 


0947 


0948 


0949 


0950 


0951 


0952 


0953 


0954 


0955 


0956 


0957 


0958 


0959 


3C0 


0960 


0961 


0962 


0963 


0964 


0965 


0966 


0967 


0968 


0969 


0970 


0971 


0972 


0973 


0974 


0975 


3D0 


0976 


0977 


0978 


0979 


0980 


0981 


0982 


0983 


0984 


0985 


0986 


0987 


0988 


0989 


0990 


0991 


3E0 


0992 


0993 


0994 


0995 


0996 


0997 


0998 


0999 


1000 


1001 


1002 


1003 


1004 


1005 


1006 


1007 


3F0 


1008 


1009 


1010 


1011 


1012 


1013 


1014 


1015 


1016 


1017 


1018 


1019 


1020 


1021 


1022 


1023 



H-6 MCS -51 Macro Assembler 



HEXADECIMAL-DECIMAL INTEGER CONVERSION (Cont'd) 



400 
410 
420 
430 

440 
450 
460 
470 

480 
490 
4A0 
4B0 



1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 

1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1062 1053 1054 1055 

1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 

1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 

1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 

1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 

1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 

1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 

1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 

1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 

1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 

1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 



4C0 


1216 


1217 


1218 


1219 


1220 


1221 


1222 


1223 


1224 


1225 


1226 


1227 


1 228 


1229 


1 230 


1231 


4 DO 


1232 


1233 


1234 


1235 


1236 


1237 


1238 


1239 


1240 


1241 


1242 


1243 


1244 


1245 


1246 


1247 


4E0 


1248 


1249 


1250 


1251 


1252 


1253 


1254 


1255 


1256 


1257 


1258 


1259 


1260 


1261 


1262 


1263 


4F0 


1264 


1265 


1266 


1267 


1268 


1269 


1270 


1271 


1272 


1273 


1274 


1275 


1276 


1277 


1278 


1279 


500 


1280 


1281 


1282 


1283 


1284 


1285 


1286 


1287 


1288 


1289 


1290 


1291 


1 292 


1 293 


1 294 


1 295 


510 


1296 


1297 


1298 


1299 


1300 


1301 


1302 


1303 


1304 


1305 


1306 


1307 


1308 


1309 


1310 


1311 


520 


1312 


1313 


1314 


1315 


1316 


1317 


1318 


1319 


1320 


1321 


1322 


1323 


1324 


1325 


1326 


1327 


530 


1328 


1329 


1330 


1331 


1332 


1333 


1334 


1335 


1336 


1337 


1338 


1339 


1340 


1341 


1342 


1343 


540 


1344 


1345 


1346 


1347 


1348 


1349 


1350 


1351 


1352 


1353 


1354 


1355 


1356 


1357 


1358 


1359 


550 


1360 


1361 


1362 


1363 


1364 


1365 


1366 


1367 


1368 


1369 


1370 


1371 


1372 


1373 


1374 


1375 


560 


1376 


1377 


1378 


1379 


1380 


1381 


1382 


1383 


1384 


1385 


1386 


1387 


1388 


1389 


1390 


1391 


570 


1392 


1393 


1394 


1395 


1396 


1397 


1398 


1399 


1400 


1401 


1402 


1403 


1404 


1405 


1406 


1407 


580 


1408 


1409 


1410 


141 1 


1412 


1413 


1414 


1415 


1416 


1417 


1418 


1419 


1420 


1421 


1422 


1423 


590 


1424 


1425 


1426 


1427 


1428 


1429 


1430 


1431 


1432 


1433 


1434 


1435 


1436 


1437 


1438 


1439 


5A0 


1440 


1441 


1442 


1443 


1444 


1445 


1446 


1447 


1448 


1449 


1450 


1451 


1452 


1453 


1454 


1455 


5B0 


1456 


1457 


1458 


1459 


1460 


1461 


1462 


1463 


1464 


1465 


1466 


1467 


1468 


1469 


1470 


1471 


5C0 


1472 


1473 


1474 


1475 


1476 


1477 


1478 


1479 


1480 


1481 


1482 


1483 


1 484 


1 AQC 


I 'too 


1 487 


5D0 


1488 


1489 


1490 


1491 


1492 


1493 


1494 


1495 


1496 


1497 


1498 


1499 


1500 


1501 


1502 


1503 


5E0 


1504 


1505 


1506 


1507 


1508 


1509 


1510 


1511 


1512 


1513 


1514 


1515 


1516 


1517 


1518 


1519 


5F0 


1520 


1521 


1522 


1523 


1524 


1525 


1526 


1527 


1528 


1529 


1530 


1531 


1532 


1533 


1534 


1535 


600 


1536 


1537 


1538 


1539 


1540 


1541 


1542 


1543 


1544 


1545 


1546 


1547 


1548 


1549 


1550 


1551 


610 


1552 


1553 


1554 


1555 


1556 


1557 


1558 


1559 


1560 


1561 


1562 


1563 


1564 


1565 


1566 


1567 


620 


1568 


1569 


1570 


1571 


1572 


1573 


1574 


1575 


1576 


1577 


1578 


1579 


1580 


1581 


1582 


1583 


630 


1584 


1585 


1586 


1587 


1588 


1589 


1590 


1591 


1592 


1593 


1594 


1595 


1596 


1597 


1598 


1599 


640 


1600 


1601 


1602 


1603 


1604 


1605 


1606 


1607 


1608 


1609 


1610 


1611 


1612 


1613 


1614 


1615 


650 


1616 


1617 


1618 


1619 


1620 


1621 


1622 


1623 


1624 


1625 


1626 


1627 


1628 


1629 


1630 


1631 


660 


1632 


1633 


1634 


1635 


1636 


1637 


1638 


1639 


1640 


1641 


1642 


1643 


1644 


1645 


1646 


1647 


670 


1648 


1649 


1650 


1651 


1652 


1653 


1654 


1655 


1656 


1657 


1658 


1659 


1660 


1661 


1662 


1663 


680 


1664 


1665 


1666 


1667 


1668 


1669 


1670 


1671 


1672 


1673 


1674 


1675 


1676 


1677 


1678 


1679 


690 


1680 


1681 


1682 


1683 


1684 


1685 


1686 


1687 


1688 


1689 


1690 


1691 


1692 


1693 


1694 


1695 


6A0 


1696 


1697 


1698 


1699 


1700 


1701 


1702 


1703 


1704 


1705 


1706 


1707 


1708 


1709 


1710 


1711 


680 


1712 


1713 


1714 


1715 


1716 


1717 


1718 


1719 


1720 


1721 


1722 


1723 


1724 


1725 


1726 


1727 


6C0 


1728 


1729 


1730 


1731 


1732 


1733 


1734 


1735 


1736 


1737 


1738 


1739 


1740 


1741 


1742 


1743 


600 


1744 


1745 


1746 


1747 


1748 


1749 


1750 


1751 


1752 


1753 


1754 


1755 


1756 


1757 


1758 


1759 


6E0 


1760 


1761 


1762 


1763 


1764 


1765 


1766 


1767 


1768 


1769 


1770 


1771 


1772 


1773 


1774 


1775 


6F0 


1776 


1777 


1778 


1779 


1780 


1781 


1782 


1783 


1784 


1785 


1786 


1787 


1788 


1789 


1790 


1791 



Reference Tables H-7 



HEXADECIMAL-DECIMAL INTEGER CONVERSION (Cont'd) 







U 


1 

1 


4 


•J 




C 




D 


7 


g 


A 

y 




A 


□ 
a 




q 


g 


p 


3 


00 


1792 


1793 


1794 


1795 


1796 


1797 


1798 


1799 


1800 


1801 


1802 


1803 


1804 


1805 


1806 


1807 


i 


10 


1808 


1809 


1810 


1 Q 1 1 
10 1 1 


ion 


1 fin 

I O 1 J 


1R14 

IOIH 


1815 


1 O ID 


1817 


1 q 1 a 


1 Q1 Q 


i aon 
1 ozu 


1821 


1822 


1823 




20 


1824 


1825 


1826 


1827 


1828 


1829 


1830 


1831 


1832 


1833 


1834 


1835 


1836 


1837 


1838 


1839 




30 


1840 


1841 


1842 


1843 


1844 


1845 


1846 


1847 


1848 


1849 


1850 


1851 


1852 


1853 


1854 


1855 


" 


40 


1856 


1857 


1858 


1859 


1860 


1861 


1862 


1863 


1864 


1865 


1866 


1867 


1868 


1869 


1870 


1871 


750 


1872 


1873 


1874 


1 fl7K 
I Of O 


1 876 


1877 


1878 


1879 


1880 


1 881 


1 QR9 
1 oo* 


i nn*) 

1 OO J 


1884 


1885 


1886 


1887 


760 


1888 


1889 


1890 


1891 


1892 


1893 


1894 


1895 


1896 


1897 


1898 


1899 


1900 


1901 


1902 


1903 


770 


1904 


1905 


1906 


1907 


1908 


1909 


1910 


1911 


1912 


1913 


1914 


1915 


1916 


1917 


1918 


1919 


780 


1920 


1921 


1922 


1923 


1924 


1925 


1926 


1927 


1928 


1929 


1930 


1931 


1932 


1933 


1934 


1935 


790 


1936 


1937 


1938 


1 QTQ 




1941 


1942 


1943 


1944 


1945 


1946 


1947 


1948 


1949 


1950 


1951 


7 AO 


1952 


1953 


1954 


1955 


1956 


1957 


1958 


1959 


1960 


1961 


1962 


1963 


1964 


1965 


1966 


1967 


7B0 


1968 


1969 


1970 


1971 


1972 


1973 


1974 


1975 


1976 


1977 


1978 


1979 


1980 


1981 


1982 


1983 


7C0 


1984 


1985 


1986 


1987 


1988 


1989 


1990 


1991 


1992 


1993 


1994 


1995 


1 996 


1997 


1998 


1999 


7D0 


2000 


2001 


2002 


2003 


2004 


2005 


2006 


2007 


2008 


2009 


2010 


201 1 


2012 


2013 


2014 


2015 




EO 


2016 


2017 


2018 


2019 


2020 


2021 


2022 


2023 


2024 


2025 


2026 


2027 


2028 


2029 


2030 


2031 


7F0 


2032 


2033 


2034 


2035 


2036 


2037 


2038 


2039 


2040 


2041 


2042 


2043 


2044 


2045 


2046 


2047 


800 


2048 


2049 


2050 


2051 


2052 


2053 


2054 


2055 


2056 


2057 


2058 


2059 


2060 


2061 


2062 


2063 


810 


2064 


2065 


2066 


2067 


2068 


2069 


2070 


2071 


2072 


2073 






2076 


on 7 7 


2078 


2079 


820 


2080 


2081 


2082 


2083 


2084 


2085 


2086 


2087 


2088 


2089 


2090 


2091 


2092 


2093 


2094 


2095 


830 


2096 


2097 


2098 


2099 


2100 


2101 


2102 


2103 


2104 


2105 


2106 


2107 


2108 


2109 


2110 


2111 


840 


2112 


2113 


2114 


2115 


2116 


2117 


2118 


2119 


2120 


2121 


2122 


2123 


2124 


2125 


2126 


2127 


850 


2128 


2129 


2130 


2131 




7 1 n 




7 1 7C 


zl JO 


2137 


2138 


2139 


2140 


2141 


2142 


2143 


860 


2144 


2145 


2146 


2147 


2148 


2149 


2150 


2151 


2152 


2153 


2154 


2155 


2156 


2157 


2158 


2159 


870 


2160 


2161 


2162 


2163 


2164 


2165 


2166 


2167 


2168 


2169 


2170 


2171 


2172 


2173 


2174 


2175 


880 


2176 


2177 


2178 


2179 


2180 


2181 


2182 


2183 


2184 


2185 


2186 


2187 


2188 


2189 


2190 


2191 




2192 


2193 


2194 


2195 


1 OA 


2 1 97 


7 i on 
c \ y a 


/ 1 yy 


2200 


2201 


2202 


2203 


2204 


2205 


2206 


2207 


8A0 


2208 


2209 


2210 


2211 


2212 


2213 


2214 


2215 


2216 


2217 


2218 


2219 


2220 


2221 


2222 


2223 


8B0 


2224 


2225 


2226 


2227 


2228 


2229 


2230 


2231 


2232 


2233 


2234 


2235 


2236 


2237 


2238 


2239 


8C0 


2240 


2241 


2242 


2243 


2244 


2245 


2246 


2247 


2248 


2249 


2250 


2251 


2252 


2253 


2254 


2255 


8D0 


2256 


2257 


2258 


2259 


2260 


2261 


2262 


2263 


2264 


2265 


2266 


2267 


2268 


t zoy 


£.£. /U 


•5*57 1 


8E0 


2272 


2273 


2274 


2275 


2276 


2277 


2278 


2279 


2280 


2281 


2282 


2283 


2284 


2285 


2286 


2287 


8F0 


2288 


2289 


2290 


2291 


2292 


2293 


2294 


2295 


2296 


2297 


2298 


2299 


2300 


2301 


2302 


2303 


900 


2304 


2305 


2306 


2307 


2308 


2309 


2310 


2311 


2312 


2313 


2314 


2315 


2316 


2317 


2318 


2319 


910 


2320 


2321 






2324 


2325 


2326 




0T.7Q 




2330 


2331 


2332 


2333 


2334 


2335 


920 


2336 


2337 


2338 


2339 


2340 


2341 


2342 


2343 


2344 


2345 


2346 


2347 


2348 


2349 


2350 


2351 


930 


2352 


2353 


2354 


2355 


2356 


2357 


2358 


2359 


2360 


2361 


2362 


2363 


2364 


2365 


2366 


2367 


940 


2368 


2369 


2370 


2371 


2372 


2373 


2374 


2375 


2376 


2377 


2378 


2379 


2380 


2381 


2382 


2383 


950 


11 OA 




2386 


2387 


2388 


2389 


2390 


2391 


2392 






2395 


2396 


2397 


2398 


2399 


960 


2400 


2401 


2402 


2403 


2404 


2405 


2406 


2407 


2408 


2409 


2410 


241 1 


2412 


2413 


2414 


2415 


970 


2416 


2417 


2418 


2419 


2420 


2421 


2422 


2423 


2424 


2425 


2426 


2427 


2428 


2429 


2430 


2431 


980 


2432 


2433 


2434 


2435 


2436 


2437 


2438 


2439 


2440 


2441 


2442 


2443 


2444 


2445 


2446 


2447 


990 


2448 


2449 


2450 


2451 


2452 


2453 


2454 


2455 


2456 


2457 


2458 


2459 


2460 


2461 


OAR*) 


2463 


9 AO 


2464 


2465 


2466 


2467 


2468 


2469 


2470 


2471 


2472 


2473 


2474 


2475 


2476 


2477 


2478 


2479 


9B0 


2480 


2481 


2482 


2483 


2484 


2485 


2486 


2487 


2488 


2489 


2490 


2491 


2492 


2493 


2494 


2495 


9C0 


2498 


2497 


2498 


2499 


2500 


2501 


2502 


2503 


2504 


2505 


2506 


2507 


2508 


2509 


2510 


2511 


900 


2512 


2513 


2514 


2515 


2516 


2517 


2518 


2519 


2520 


2521 


2522 


2523 


2524 


2525 


2526 


2527 


9E0 


2528 


2529 


2530 


2531 


2532 


2533 


2534 


2535 


2536 


2537 


2538 


2539 


2540 


2541 


2542 


2543 


9F0 


2544 


2545 


2546 


2547 


2548 


2549 


2550 


2551 


2552 


2553 


2554 


2555 


2556 


2557 


2558 


2559 



H-8 MCS--51 Macro Assembler 



HEXADECIMAL-DECIMAL INTEGER CONVERSION (Cont'd) 










1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


A00 




2560 


2561 


2562 


2563 


2564 


2565 


2566 


2567 


2568 


2569 


2570 


2571 


2572 


2573 


2574 


2575 


A10 




2576 


2577 


2578 


2579 


2580 


2581 


2582 


2583 


2584 


2585 


2586 


2587 


2588 


2589 


2590 


2591 


A20 




2592 


2593 


2594 


2595 


2596 


2597 


2598 


2599 


2600 


2601 


2602 


2603 


2604 


2605 


2606 


2607 






2608 


2609 


2610 


261 1 


261 2 


2613 


2614 


2615 


2616 


2617 


2618 


2619 


2620 


2621 


2622 


2623 


A40 




2624 


2625 


2626 


2627 


2628 


2629 


2630 


2631 


2632 


2633 


2634 


2635 


9fi^fi 




ZOJO 




A50 




2640 


2641 


2642 


2643 


2644 


2645 


2646 


2647 


2648 


2649 


2650 


2651 


2652 


2653 


2654 


2655 


A60 




2656 


2657 


2658 


2659 


2660 


2661 


2662 


2663 


2664 


2665 


2666 


2667 


2668 


2669 


2670 


2671 


A70 




2672 


2673 


2674 


2675 


2676 


2677 


2678 


2679 


2680 


2681 


2682 


2683 


2684 


2685 


2686 


2687 


A80 




2688 


2689 


2690 


2691 


2692 


2693 


2694 


2695 


2696 


2697 


2698 


2699 


t /uu 


2701 


9709 




A90 




2704 


2705 


2706 


2707 


2708 


2709 


2710 


271 1 


2712 


2713 


2714 


2715 


2716 


2717 


2718 


2719 


AAO 




2720 


2721 


2722 


2723 


2724 


2725 


2726 


2727 


2728 


2729 


2730 


2731 


2732 


2733 


2734 


2735 


ABO 




2736 2737 2738 2739 


z /**u 


T7 A 1 
4.1** \ 


tilt 


2743 


2744 


2745 


2746 


2747 


2748 


2749 


2750 


2751 


ACO 




2752 


2753 


2754 


2755 


2756 


2757 


2758 


2759 


2760 


4761 


2762 


2763 


2764 


2765 


2766 


2767 


ADO 




2768 


2769 


2770 


2771 


2772 


2773 


2774 


2775 


2776 


2777 


2778 


2779 


2780 


2781 


2782 


2783 


AEO 




2784 


2785 


2786 


2787 


2788 


2789 


2790 


2791 


2792 


2793 


2794 


2795 


2796 


2797 


2798 


2799 


AFO 




zaw 


2801 


2802 


2803 




zouu 


2806 


2807 


2808 


2809 


2810 


281 1 


2812 


2813 


2814 


2815 


BOO 




2816 


2817 


2818 


2819 


2820 


2821 


2822 


2823 


2824 


2825 


2826 


2827 


2828 


2829 


2830 


2831 


B10 




2832 


2833 


2834 


2835 


2836 


2837 


2838 


2839 


2840 


2841 


2842 


2843 


2844 


2845 


2846 


2847 


B20 




2848 


2849 


2850 


3851 


2852 


2853 


2854 


2855 


2856 


2857 


2858 


2859 


2860 


2861 


2862 


2863 


B30 




2864 


2865 


2866 


2867 


2868 


2869 


2870 


2871 


2872 


2873 


2874 


2875 


2376 


2877 


2878 


2879 


B40 




2880 


2881 


2882 


2883 


2884 


2885 


2866 


2887 


2888 


2889 


2890 


2891 


TOO 9 


2893 


2894 


2895 


850 




2896 


2897 


2898 


2899 


2900 


2901 


2902 


2903 


2904 


2905 


2906 


2907 


2908 


2909 


2910 


291 1 


B60 




291 2 


2913 


2914 


2915 


2916 


2917 


2918 


2919 


2920 


2921 


2922 


2923 


2924 


2925 


2926 


2927 


a /U 




2928 


2929 2930 


2931 


2932 


2933 


2934 


2935 


2936 


2937 


2938 


2939 


2940 


2941 


2942 


2943 


B80 




2944 


2945 


2946 


2947 


2948 


2949 


2950 


2951 


2952 


2953 


2954 


2955 




2957 


2958 


2959 


B90 




2960 


2961 


2962 


2963 


2964 


2965 


2966 


2967 


2968 


2969 


2970 


2971 


2972 


2973 


2974 


2975 


BAO 




2976 


2977 


2978 


2979 


2980 


2981 


2982 


2983 


2984 


2985 


2986 


2987 


2988 


2989 


2990 


2991 


BBO 




2992 


2993 


2994 


2995 


2996 


2997 


2998 


2999 


3000 




3002 


3003 


3004 


3005 


3006 


3007 


BCO 




3008 


3009 


3010 


3011 


3012 


3013 


3014 


3015 


3016 


3017 


3018 


3019 


3020 


3021 


3022 


3023 


BDO 




3024 


3025 


3026 


3027 


3028 


3029 


3030 


3031 


3032 


3033 


3034 


3035 


3036 


3037 


3038 


3039 


BEO 




3040 


3041 


3042 


3043 


3044 


3045 


3046 


3047 


3048 


3049 


3050 


3051 


3052 


3053 


3054 


3055 


BFO 




3056 


3057 


3058 


3059 


3060 


306 1 




JUDJ 




3065 


3066 


3067 


3068 


3069 


3070 


3071 


COO 




3072 


3073 


3074 


3075 


3076 


3077 


3078 


3079 


3080 


308 1 


3082 


3083 


3084 


3085 


3086 


3087 


C10 




3088 


3089 


3090 


3091 


3092 


3093 


3094 


3095 


3096 


3097 


3098 


3099 


3100 


3101 


3102 


3103 


C20 




3104 


3105 


3106 


3107 


3108 


3109 


3110 


3111 


3112 


3113 


3114 


3115 


3116 


3117 


3118 


3119 






3120 


3121 


3122 


3123 


3124 


3125 


3126 


3127 


3128 


3129 


3130 


3131 


3132 


3133 


3134 


3135 


C40 




3136 


3137 


3138 


3139 


3140 


3141 


3142 


3143 


3 1 44 


3145 


3146 


3147 


3148 


3149 


3150 


3151 


C50 




3152 


3153 


3154 


3155 


3156 


3157 


3158 


3159 


3160 


3161 


3162 


3163 


3164 


3165 


3166 


3167 


C60 




3168 


3169 


3170 


3171 


3172 


3173 


3174 


3175 


3176 


3177 


3178 


3179 


3180 


3181 


3182 


3183 


C70 




3184 


3185 


3186 


3187 


3188 


3189 


3190 


3191 


3192 


3193 


3194 


3195 


3196 


3197 


3198 


3199 


C80 




3200 


3201 


3202 


3203 


3204 


3205 


3206 


3207 


3208 


3209 


321 


321 1 


321 2 


3213 


3214 


3215 


C90 




3216 


3217 


3218 


3219 


3220 


3221 


3222 


3223 


3224 


3225 


3226 


3227 


3228 


3229 


3230 


3231 


CAO 




3232 


3233 


3234 


3235 


3236 


3237 


3238 


3239 


3240 


3241 


3242 


3243 


3244 


3245 


3246 


3247 


CBO 




3248 


3249 


3250 


3251 


3252 


3253 


3254 


3255 


3256 


3257 


3258 


3259 


3260 


3261 


3262 


3263 


CCO 




3264 


3265 


3266 


3267 


3268 


3269 


3270 


3271 


3272 


3273 


3274 


3275 


3276 


3277 


3278 


3279 


CDO 




3280 


3281 


3282 


3283 


3284 


3285 


3286 


3287 


3288 


3289 


3290 


3291 


3292 


3293 


3294 


3295 


CEO 




3296 


3297 


3298 


3299 


3300 


3301 


3302 


3303 


3304 


3305 


3306 


3307 


3308 


3309 


3310 


3311 


CFO 




3312 


3313 


3314 


3315 


3316 


3317 


3318 


3319 


3320 


3321 


3322 


3323 


3324 


3325 


3326 


3327 



I 



Reference Tables H-9 



HEXADECIMAL-DECIMAL INTEGER CONVERSION (Cont'd) 





u 


1 
1 


£ 


J 


4 


5 


g 


7 


8 


g 


A 


B 


C 


D 


E 


F 


D00 


3328 


3329 


3330 


3331 


3332 


3333 


3334 


3335 


3336 


3337 


3338 


3339 


3340 


3341 


3342 


3343 


D10 


3344 


3345 


3346 


3347 


3348 


3349 


3350 


3351 


3352 


3353 


3354 


3355 


3356 


3357 


3358 


3359 


D20 


3360 


3361 


3362 


3363 


3364 


3365 


3366 


3367 


3368 


3369 


3370 


3371 


3372 


3373 


3374 


3375 


D30 


3376 


3377 


3378 


3379 


3380 


3381 


3382 


3383 


3384 


3385 


3386 


3387 


3388 


3389 


3390 


3391 


D40 


3392 


3393 


3394 


3395 


3396 


3397 


3398 


3399 


3400 


3401 


3402 


3403 


3404 


3405 


3406 


3407 


D50 


3408 




id in 


-3** 1 1 


341 2 


3413 


3414 


3415 


3416 


3417 


3418 


3419 


3420 


3421 


3422 


3423 


D60 


3424 


3425 


3426 


3427 


3428 


3429 


3430 


3431 


3432 


3433 


3434 


3435 


3436 


3437 


3438 


3439 


D70 


3440 


3441 


3442 


3443 


3444 


3445 


3446 


3447 


3448 


3449 


3450 


3451 


3452 


3453 


3454 


3455 


D80 


3456 


3457 


3458 


3459 


3460 


3461 


3462 


3463 


3464 


3465 


3466 


3467 


3468 


3469 


3470 


3471 


D90 


3472 


3473 


3474 


3475 


3476 


3477 


3478 


Id 7Q 

j** / y 




3481 


3482 


3483 


3484 


3485 


3486 


3487 


OAO 


3488 


3489 


3490 


3491 


3492 


3493 


3494 


3495 


3496 


3497 


3498 


3499 


3500 


3501 


3502 


3503 


DBO 


3504 


3505 


3506 


3507 


3508 


3509 


3510 


3511 


3512 


3513 


3514 


3515 


3516 


3517 


3518 


3519 


DCO 


3520 


3521 


3522 


3523 


3524 


3525 


3526 


3527 


3528 


3529 


3530 


3531 


3532 


3533 


3534 


3535 


nnn 
uuu 


TC-JC 
JDJD 


J Do / 


JDJO 


TRIO 

jojy 


JD**U 


QCvl 1 

JOt 1 


3542 


3543 


3544 


3545 


3546 


3547 


3548 


3549 


3550 


3551 


DEO 


3552 


3553 


3554 


3555 


3556 


3557 


3558 


3559 


3560 


3561 


3562 


3563 


3564 


3565 


3566 


3567 


DFO 


3568 


3569 


3570 


3571 


3572 


3573 


3574 


3575 


3576 


3577 


3578 


3579 


3580 


3581 


3582 


3583 


E00 


3584 


3585 


3586 


3587 


3588 


3589 


3590 


3591 


3592 


3593 


3594 


3595 


3596 


3597 


3598 


3599 


E10 


3600 


3601 


3602 


3603 


3604 


3605 


3606 


3607 


3608 


3609 


3610 


361 1 


361 2 


3613 


3614 


361 5 


E20 


3616 


3617 


3618 


3619 


3620 


3621 


3622 


3623 


3624 


3625 


3626 


3627 


3628 


3629 


3630 


3631 


E30 


3632 


3633 


3634 


3635 


3636 


3637 


3638 


3639 


3640 


3641 


3642 


3643 


3644 


3645 


3646 


3647 


E40 


3648 


3649 


3650 


3651 


3652 


3653 


3654 


3655 


3656 


3657 


3658 


3659 


3660 


3661 


3662 


3663 


E50 


3664 


3665 


3666 


3667 


3668 


3669 


3670 


3671 


3672 


3673 


3674 


3675 


3676 


3677 


3678 


3679 


E60 


3680 


3681 


3682 


3683 


3684 


3685 


3686 


3687 


3688 


3689 


3690 


3691 


3692 


3693 


3694 


3695 


E70 


3696 


3697 


3698 


3699 


3700 


3701 


3702 


3703 


3704 


3705 


3706 


3707 


3708 


3709 


3710 


3711 


E80 


3712 


3713 


3714 


3715 


3716 


3717 


3718 


3719 


3720 


3721 


3722 


3723 


3724 


3725 


3726 


3727 


E90 


3728 


3729 


3730 


3731 


3732 


3733 


J / J** 


J' JO 


J / JO 


J / J 1 


J / JO 


J / J» 


J /*»U 


T74 1 
J /*» 1 


J fH 


J J 


EAO 


3744 


3745 


3746 


3747 


3748 


3749 


3750 


3751 


3752 


3753 


3754 


3755 


3756 


3757 


3758 


3759 


EBO 


3760 


3761 


3762 


3763 


3764 


3765 


3766 


3767 


3768 


3769 


3770 


3771 


3772 


3773 


3774 


3775 


ECO 


3776 


3777 


3778 


3779 


3780 


3781 


3782 


3783 


3784 


3785 


3786 


3787 


3788 


3789 


3790 


3791 


EDO 


3792 


3793 


3794 


3795 


3796 


3797 


3798 


3799 


3800 


3801 


3802 


3803 


3804 


3805 


3806 


3807 


EEO 


3808 


3809 


3810 


3811 


3812 


3813 


3814 


3815 


3816 


3817 


3818 


3819 


3820 


3821 


3822 


3823 


EFO 


3824 


3825 


3826 


3827 


3828 


3829 


3830 


3831 


3832 


3833 


3834 


3835 


3836 


3837 


3838 


3839 


FOO 


3840 


3841 


3842 


3843 


3844 


3845 


3846 


3847 


3848 


3849 


3850 


3851 


3852 


3853 


3854 


3855 


F10 


3856 




TOCO 


3859 


JDOU 


Iftfil 

JOD 1 


JOD Z 


-1QC-J 
JOOJ 


-IOC* 
JOD** 


JOD 3 


JODO 


JOO / 


JOOO 


JOD 3 


JO/U 


1Q71 
JO / 1 


F20 


3872 


3873 


3874 


3875 


3876 


3877 


3878 


3879 


3880 


3881 


3882 


3883 


3884 


3885 


3886 


3887 


F30 


3888 


3889 


3890 


3891 


3892 


3893 


3894 


3895 


3896 


3897 


3898 


3899 


3900 


3901 


3902 


3903 


F40 


3904 


3905 


3906 


3907 


3908 


3909 


3910 


3911 


3912 


3913 


3914 


3915 


3916 


3917 


3918 


3919 


F50 


3920 


3921 


3922 


3923 


3924 


3925 


3926 


3927 


3928 






jyj I 


3932 


3933 


3934 


3935 


F60 


3936 


3937 


3938 


3939 


3940 


3941 


3942 


3943 


3944 


3945 


3946 


3947 


3948 


3949 


3950 


3951 


F70 


3952 


3953 


3954 


3955 


3956 


3957 


3958 


3959 


3960 


3961 


3962 


3963 


3984 


3965 


3966 


3967 


F80 


3968 


3969 


3970 


3971 


3972 


3973 


3974 


3975 


3976 


3977 


3978 


3979 


3980 


3981 


3982 


3983 


F90 


3984 


3985 


3986 


3987 


3988 


3989 


3990 


3991 


3992 


3993 


3994 


3995 


3996 


3997 


3998 


3999 


FAO 


4000 


4001 


4002 


4003 


4004 


4005 


4006 


4007 


4008 


4009 


4010 


4011 


4012 


4013 


4014 


4015 


FBO 


4016 


4017 


4018 


4019 


4020 


4021 


4022 


4023 


4024 


4025 


4026 


4027 


4028 


4029 


4030 


4031 


FCO 


4032 


4033 


4034 


4035 


4036 


4037 


4038 


4039 


4040 


4041 


4042 


4043 


4044 


4045 


4046 


4047 


FDO 


4048 


4049 


4050 


4051 


4052 


4053 


4054 


4055 


4056 


4057 


4058 


4059 


4060 


4061 


4062 


4063 


FEO 


4064 


4065 


4066 


4067 


4068 


4069 


4070 


4071 


4072 


4073 


4074 


4075 


4076 


4077 


4078 


4079 


FFO 


4080 


4081 


4082 


4083 


4084 


4085 


4086 


4087 


4088 


4089 


4090 


4091 


4092 


4093 


4094 


4095 



Error Messages 




When the assembler is unable to correctly assemble a source file, it generates an 
error message describing the trouble. If possible, it will continue execution. In some 
cases the assembler is unable to continue (e.g., too many symbols in a program), and 
it must abort execution. If your program should generate an error message, make 
the necessary corrections and reassemble. The object file will probably not be 
executable, and, if the error caused an abort, the list file may also be unreadable. 

The general format for all errors listed in your code is shown below: 

•" ERROR »eee, LINE #111 (ppp), Message 

where: 

eee is the error number 

III is the line causing the error 

ppp is the line causing the lost error 

Message is the error message. 

(See Chapter 6 for a complete description of all error messages generated by the 
assembler.) 



J-2 MCS S -51 Macro Assembler 

Source File Error Messages 

This type of error is caused by syntactic errors in your source code. They appear in 
your listing file immediately following the source line that caused the error. 



In attempting to further define the error, ASM51 may generate more than one 
message for a single error. Since the assembler attempts to continue processing your 
code, a single error may have side effects that cause subsequent errors. 

A list of all Assembler Error messages is shown below: 

Assembler Error Messages 

1 SYNTAX ERROR 

2 SOURCE LINE LISTING TERMINATED AT 255 CHARACTERS 

3 ARITHMETIC OVERFLOW IN NUMERIC CONSTANT 

4 ATTEMPT TO DIVIDE BY ZERO 

5 EXPRESSION WITH FORWARD REFERENCE NOT ALLOWED 

6 TYPE OF SET SYMBOL DOES NOT ALLOW REDEFINITION 

7 EQU SYMBOL ALREADY DEFINED 

8 ATTEMPT TO ADDRESS NON-BIT-ADDRESSABLE BIT 

9 BAD BIT OFFSET IN BIT ADDRESS EXPRESSION 

10 TEXT FOUND BEYOND END STATEMENT— IGNORED 

11 PREMATURE END OF FILE (NO END STATEMENT) 

12 ILLEGAL CHARACTER IN NUMERIC CONSTANT 

13 ILLEGAL USE OF REGISTER NAME IN EXPRESSION 

14 SYMBOL IN LABEL FIELD ALREADY DEFINED 

15 ILLEGAL CHARACTER 

16 MORE ERRORS DETECTED, NOT REPORTED 

17 ARITHMETIC OVERFLOW IN LOCATION COUNTER 

18 UNDEFINED SYMBOL 

19 VALUE WILL NOT FIT INTO A BYTE 

20 OPERATION INVALID IN THIS SEGMENT 

21 STRING TERMINATED BY END-OF-LINE 

22 STRING LONGER THAN 2 CHARACTERS NOT ALLOWED IN THIS CONTEXT 

23 STRING, NUMBER, OR IDENTIFIER CANNOT EXCEED 225 CHARACTERS 

24 DESTINATION ADDRESS OUT OF RANGE FOR INBLOCK REFERENCE 

25 DESTINATION ADDRESS OUT OF RANGE FOR RELATIVE REFERENCE 

26 SEGMENT SYMBOL EXPECTED 

27 ABSOLUTE EXPRESSION EXPECTED 

28 REFERENCE NOT TO CURRENT SEGMENT 

29 IDATA SEGMENT ADDRESS EXPECTED 

30 PUBLIC ATTRIBUTE NOT ALLOWED FOR THIS SYMBOL 

31 EXTERNAL REFERENCE NOT ALLOWED IN THIS CONTEXT 

32 SEGMENT REFERENCE NOT ALLOWED IN THIS CONTEXT 

33 TOO MANY RELOCATABLE SEGMENTS 

34 TOO MANY EXTERNAL SYMBOLS 

35 LOCATION COUNTER MAY NOT POINT BELOW SEGMENT BASE 

36 CODE SEGMENT ADDRESS EXPECTED 

37 DATA SEGMENT ADDRESS EXPECTED 

38 XDATA SEGMENT ADDRESS EXPECTED 

39 BIT SEGMENT ADDRESS EXPECTED 

40 BYTE OF BIT ADDRESS NOT IN BIT-ADDRESSABLE DATA SEGMENT 

41 INVALID HARDWARE REGISTER 

42 BAD REGISTER BANK NUMBER 

43 INVALID SIMPLE RELOCATABLE EXPRESSION 

44 INVALID RELOCATABLE EXPRESSION 

45 INPAGE RELOCATED SEGMENT OVERFLOW 

46 INBLOCK RELOCATED SEGMENT OVERFLOW 

47 BIT ADDRESSABLE RELOCATED SEGMENT OVERFLOW 

48 ILLEGAL RELOCATION FOR SEGMENT TYPE 



Error Messages J-3 



49 RELOCATABLE EXPRESSION TOO COMPLEX 

50 ATTEMPT TO REDEFINE A RESERVE SYMBOL 

51 SYMBOL ALREADY DEFINED AS PUBLIC 



Macro Error Messages 

Macro errors are caused by errors using the Macro Processing Language (MPL). 
They are listed immediately following the line in which the error was recognized, and 
is followed by a trace of the macro call/expression stack. This is not necessarily the 
line that contains the error. 

Since the Macro Processor attempts to define the error completely, several messages 
may be generated. A macro error may be responsible for subsequent macro errors 
and assembler errors. 

All of the Macro Error messages are listed below: 



Macro Error Messages 



300 MORE ERRORS DETECTED. NOT REPORTED 

301 UNDEFINED MACRO NAME 

302 ILLEGAL EXIT MACRO 

303 FATAL SYSTEM ERROR 

304 ILLEGAL EXPRESSION 

305 MISSING "Ft" IN "IF" 

306 MISSING "THEN" IN "IF" 

307 ILLEGAL ATTEMPT TO REDEFINE MACRO 

308 MISSING IDENTIFIER IN DEFINE PATTERN 

309 MISSING BALANCED STRING 

310 MISSING LIST ITEM 

311 MISSING DELIMITER 

312 PREMATURE EOF 

313 DYNAMIC STORAGE (MACROS OR ARGUMENTS) OVERFLOW 

314 MACRO STACK OVERFLOW 

315 INPUT STACK OVERFLOW 

317 PATTERN TOO LONG 

318 ILLEGAL METACHARACTER: <char> 

319 UNBALANCED ")" IN ARGUMENTTO USER DEFINED MACRO 

320 ILLEGAL ASCENDING CALL 



J-4 MCS®-51 Macro Assembler 



Control Error Messages 

Control errors are announced when something is wrong with the invocation line or a 
control line in the source file. In general, command language errors are fatal, caus- 
ing ASM51 to abort assembly. However, the errors listed below are not considered 
fatal. 



Control Error Messages 

400 MORE ERRORS DETECTED NOT REPORTED 

401 BAD PARAMETER TO CONTROL 

402 MORE THAN ONE INCLUDE CONTROL ON A SINGLE LINE 

403 ILLEGAL CHARACTER IN COMMAND 

406 TOO MANY WORKFILES — ONLY FIRST TWO USED 

407 UNRECOGNIZED CONTROL OR MISPLACED PRIMARY CONTROL: <COntrol> 

408 NO TITLE FOR TITLE CONTROL 

409 NO PARAMETER ALLOWED WITH ABOVE CONTROL 

410 SAVE STACK OVERFLOW 

411 SAVE STACK UNDERFLOW 

413 PAGEWIDTH BELOW MINIMUM. SET TO 80 

414 PAGELENGTH BELOW MINIMUM, SETTO 10 

415 PAGEWIDTH ABOVE MAXIMUM. SETTO 132 



Error Messages J-5 



Special Assembler Error Messages 

These error messages are displayed on the console. They are displayed immediately 
before the assembler aborts operation. You should never receive one of these errors; 
if you should encounter this type of error notify Intel Corporation via the Software 
Problem Report included with this manual. The content of all output files will be 
undefined. A list of all of the special assembler error messages is shown below: 



Special Assembler Error Messages 

800 UNRECOGNIZED ERROR MESSAGE NUMBER 

801 SOURCE FILE READING UN SYNCHRONIZED 

802 INTERMEDIATE FILE READING UNSYNCHRONIZED 

803 BAD OPERAND STACK POP REQUEST 

804 PARSE STACK UNDERFLOW 

805 INVALID EXPRESSION STACK CONFIGURATION 



J-6 MCS -51 Macro Assembler 



Fatal Error Messages 

This type of error causes the assembler to cease normal processing and produce only 
the listing. 



900 USER SYMBOL TABLE SPACE EXHAUSTED 

901 PARSE STACK OVERFLOW 

902 EXPRESSION STACK OVERFLOW 

903 INTERMEDIATE FILE BUFFER OVERFLOW 

904 USER NAME TABLE SPACE EXHAUSTED 



Invocation Line Error Messages 

Invocation line errors cause the assembler to abort execution. 

NO SOURCE FILE FOUND IN INVOCATION 
UNRECOGNIZED SOURCE FILE NAME 
ILLEGAL SOURCE FILE SPECIFICATION 
SOURCE TEXT MUST COME FROM A FILE 
NOT ENOUGH MEMORY 

AND FILES ARE THE SAME 
BAD WORKFILES COMMAND 
BAD WORKFILES SYNTAX 
BADPAGELENGTH 
BAD PAGEWIDTH 

PAGELENGTH MISSING A PARAMETER 

PAGEWIDTH MISSING A PARAMETER 

DATE MISSING A PARAMETER 

CANNOT HAVE INCLUDE IN INVOCATION 

EOL ENCOUNTERED IN PARAMETER 

COMMAND TOO LONG 

ILLEGAL CHARACTER IN INVOCATION 

UNRECOGNIZED COMMAND : <control name> 

NO PARAMETER ALLOWED WITH control 

TITLE MISSING A PARAMETER 

TOO MANY RESTORES 

NO PARAMETER GIVEN FOR "REGISTERS AN KS" 
ERROR IN PARAMETER LIST FOR "REGISTERBANKS" 



Changing Absolute Programs to 
Relocatable Programs 




The program example on the following pages (figure K-l) illustrates an absolute 
program written to run on any member of the MCS-51 family of single-chip proces- 
sors. This program includes two simple ASCII-binary conversion routines and a set 
of output routines. 

The structure of this sample program can be examined and contrasted to the sample 
modular program shown in Appendix G. 




MCS-51 MACRO ASSEMBLER 



system-id MCS-51MACR0 ASSEMBLER. Vx.y 
OBJECT MODULE RE&UESTED 

ASSEMBLER INVOKED BY : ASM51 SAMPLE.A51 NOOJ 

LOC OBJ LINE SOURCE 



OBBC 
OBCO 
0BC4 
0BC8 
OBCC 
OBDO 
OBD2 
08D3 
OBD7 
OBDB 
OBDF 
0BE3 
0BE7 
0BE9 
OBEA 
OBEE 
0BF2 
0BF6 
OBFA 
OBFE 
OCOl 
0CO2 
0C06 
OCOA 
OCOD 



54595045 

205E5820 

544F2052 

45545950 

45204120 

(E554D42 

4552 

00 

54595045 

20494E20 

46495253 

54204E55 

4D424552 

3A2 

00 

54595045 

20494E20 

5345434F 

4E44204E 

554D4245 

523A20 

00 

54484520 
53554D20 
495320 



NAME SAMPLE 

CSEG 

ORG 3 00 

; STRING DEFINITIONS 

TYPO_MSG: db 'TYPE "X TO RETYPE A NUMBER', 00H 



NUM1 MSG: db 1 TYPE IN FIRST NUMBER: 



NUM2 MSG: db 'TYPE IN SECOND NUMBER: 



[_MSG: db 'THE SUM IS • , OOH 



0000 

0000 758920 

0003 758D03 
0006 7598DA 
0009 D28E 



OOOB 900BB8 
OOOE 120067 
0011 12005A 

0014 900BD3 



CSEG 

; This is the initializing section. Execution alwa 
ys 

; starts at address on power-up. 
ORG 

mov TMOD, #00100000B ; set timer mode to auto-rel 
oad 

mov THl,#(-253) ; set timer for 110 BAUD 

mov SCON, #11011010B j prepare the Serial Port 
setb TR1 ; start clock 

; This is the main program. It's an infinite loop, 
; where each iteration prompts the console for 2 
; input numbers and types out their sum. 
START : 

; type message explaining how to correct a typo 
mov DPTR, #typo_msg 
call put_string 
call put_crlf 

; get first number from console 
mov DPTR,#numl msg 








Figure K-1. Sample Absolute Program 



K-2 MCS®-51 Macro Assembler 



MCS-51 MACRO ASSEMBLER 



mm/dd/yy page 



LOC OBJ 

0017 120067 
001A 12005A 
001D 7830 
001F 120082 
0022 12005A 

0025 900BEA 
0028 120067 
002B 12005A 
002E 7834 
0030 120082 
0033 12005A 

0036 7930 
0038 12009F 
003B 7934 
003D 12009F 

0040 E530 
0042 2534 
0044 F538 

0046 7938 
0048 1200C5 

004B 900C02 
004E 120067 
0051 7938 
0053 7A04 
0055 120072 
0058 80B1 



0008 
0008 



0030 
0030 
0034 
0038 



,INE SOURCE 

30 call putstring 

31 call put__crlf 

32 mov R0,#numl 
3 3 call get_num 

34 call putcrlf 

35 ; get second number from console 

36 mov DPTR, *num2_msg 

37 call put_string 

38 call put_crlf 

3 9 mov R0 , #num2 

40 call get_num 

41 call put_crlf 

42 ; convert the ASCII numbers to binary 

43 mov Rl,flnuml 

44 call ascbin 

4 5 mov Rl , flnum2 

46 call ascbin 

47 ; add the 2 numbers, and store the results in SUM 
4 8 mov a, numl 

49 add a , num2 

50 mov sum, a 

51 ; convert SUM from binary to ASCII 

52 mov Rl.flsum 

53 call binasc 

54 ; output sum to console 

55 mov DPTR, #sum_msg 

56 call put_string 

57 mov Rl, #sum 

58 mov R2,*4 

59 call put_data_str 

60 jmp start 
61 

62 DSEG 

63 ORG 8 

64 STACK: ds 



; at power-up the stack pointer is 
;initialized to point here 



DSEG 
ORG 3 OH 
NUM1: d: 
NUM2 : d; 
SUM: d: 



000D 
000A 
005A A900 



005C 740D 
005E 12007A 
0061 740A 
0063 12007A 
0066 22 



0067 E4 

0068 93 

0069 6006 
006B 12007A 
006E A3 
006F 80F6 

0071 22 



91 
92 



100 
101 
102 



CSEG 

; This is the console IO routine cluster. 



; This routine outputs a Carriage Return and 



; carriage return 
; line feed 

; R0 value may be neede 



Line Feed 
PUT CRLF : 
CR equ 0DH 
LF equ OAH 

lOV Rl,0OH 
d for restart 

mov A,#cr 

call put_char 

mov A,#lf 

call put_char 
ret 



; This routine outputs a null-terminated string lo 
cated 

; in CODE memory, whose address is given in DPTR. 
PUTSTRING : 
clr A 

move A, GA+DPTR 
jz exit 
- call put_char 
inc DPTR 
jmp put_string 
EXIT: 
ret 

; 

; This routine outputs a string located in DATA me 
mory , 



I 

Figure K-1. Sample Absolute Program (Cont'd.) 
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MCS-51 MACRO ASSEMBLER 




LOC 


OBJ 


LINE 






103 






104 


0072 


E7 


105 


0073 


12007A 


106 


0076 


09 


107 


0077 


DAF9 


108 


0079 


22 


109 






110 






111 






112 






113 


007A 


3099FD 


114 








O07F 


F599 


116 




22 














1 to 






120 












122 


0082 


7A04 


123 


0084 


A9 00 


124 






125 


0086 


120097 


126 






127 


0089 


C2E7 


128 




B4 1904 




008E 


115A 


130 




80F0 








132 




F7 




0093 


09 


134 


0094 


DAFO 


135 


0096 


22 


136 






137 






138 






139 






140 


0097 


3098FD 


141 


009A 


C298 


142 


009C 


E599 


143 


009E 


22 


144 






145 






146 






147 






148 






149 






150 


0030 


151 


002B 


152 


002D 


153 






154 






155 






156 






157 






158 






159 






160 






161 


009F 


A801 


162 



; whose address is in Rl and its length in R2. 
PUT_DATA_STR: 

mov A,6R1 

call putchar 

inc Rl 

djnz R2,put_data_str 
ret 

; This routine outputs a single character to conso 
le. 

; The character is given in A. 
PUT CHAR: 

Jnb TI , S 

clr TI 

mov SBUF,A 

ret 

; This routine gets a 4 character string from cons 
ole, 

; and stores it in memory at the address given in 
R0. 

; If a *X is received, routine starts over again. 
GET_NUM : 

mov R2,#4 ; set up string length 

as 4 

mov Rl,0OH | R0 value may be neede 

d for restart 
GET^LOOP: 

call get_char 
; Next 4 instructions handle A X- routine starts ov 
er if received 

clr ACC.7 ; clear the parity bit 

cjne A, #19H,GO_ON ; if not *X- go on 

call put_crlf 

jmp get_num 

GO_ON : 

mov @R1 , A 
inc Rl 

djnz R2,get_loop 
ret 

; This routine gets a single character from consol 
e . 

; The character is returned in A. 
GET_CHAR: 

j nb Rl , $ 

Clr Rl 
mov A.SBUF 
ret 

; This module handles conversian from ASCII to bin 
ary and back 

; The binary numbers are signed one-byte integers, 
i.e. their 

; range is -128 to +127. The ASCII represantation 
is always 4 

; characters long- i.e. a sign followed by 3 digit 



ZERO EQU '0' 
PLUS EQU '+' 

MINUS EQU '-• 

; This routine converts ASCII to binary. 

; INPUT- a 4 character string pointed at by Rl. T 

he number range 

must be -128 to +127, and the string must hav 
e 3 digits 

; preceded by a sign. 

; OUTPUT- a signed one-byte integer, located where 
the input 

; string started (pointed at by Rl) . 
ASCBIN: 

mov R0,001H ; Rl original value wi 

11 be needed later 



Figure K-1. Sample Absolute Program (Cont'd.) 
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MCS-51 MACRO AS 


SEMBLER 


SAMPLE 01/14/86 PAGE 4 








LOC OBJ 


LINE 


SOURCE 










163 


; Compute first digit value, and store it temporar 












ily in TEMP 








REG 


164 


TEMP SCru R3 








00A1 08 


165 


lnc RO 








00A2 E6 


166 


mov A , @R0 








0OA3 9430 


167 


subb A, If zero 








00A5 75F064 


168 


raov B, # 100 








0OA8 A4 


169 


mU ^ 






00A9 FB 


170 


Jiov TEMP, A 








171 


; Compute the second digit value 






OOAA 08 


172 


inc 








OOAB E6 


173 


mov A , pRO 








OOAC 94 30 


174 


subb A, # zero 








OOAE 75F00A 


175 


mov B , # 1 








00B1 A4 


176 


mul AB 










177 


; Add the value or the second digit to num. 








0OB2 2B 


178 


add A, TEMP 








O0B3 FB 


179 


mov TEMP, A 












; get third digit and its value to total 








00B4 OS 


1 HI 


inc R0 








00B5 E6 


182 


mov A,@R0 








U 1. O J l i J -■ 




subb A, ttzero 








uu do * a 




add A, TEMP 








O0B9 FB 


185 


mov TEMP , A 










186 


; test the sign, and complement the value if it's 












negative 








U U OA tu i 




mov A, @R1 








UUBt) 04^DU4 


TOO 

188 


cjne A,#minus,pos ;skip the next 4 instruct 












ions if positive 








OOBE EB 


189 


mov A , TEMP 








OOBF F4 


190 


cpl A 








OOCO 04 




inc A 








O0C1 FB 


192 


mov TEMP , A 










193 












194 


; epilogue- store the result and exit 










195 


pos: 








O0C2 EB 


196 


mov A, TEMP 








O0C3 F7 


197 


mov ?R1,A 








00C4 22 


198 


ret 










199 


; 










200 


; This routine converts binary to ASCII. 










201 


; INPUT- a signed one-byte integer, pointed at by 






















202 


; OUTPUT- a signed one-byte integer 










203 


; OUTPUT- a 4 character string, located where the 












input number 










204 


was (pointed at by Rl) . 










205 


BINASC : 








00E7 


206 


SIGN bit ACC.7 








00C5 E7 


207 


; Get the number, find its sign and store its sign 








208 


mov A f @Rl 








00C6 772B 


209 


mov @Rl,#plus ;store a plus sign (over- 












written 








00C8 30E704 


210 


; by minus if needed) 








211 


jnb sign,go_on2 ;test the sign bit 










212 


; Next 3 instructions handle negative numbers 








OOCB 772D 


213 


mov @Rl,#minus ; store a minus sign 








OOCD 14 


214 


dec A 








OOCE F4 


215 


Cpl A 










216 


; Factor out the first digit 










217 


GO ON2: 








OOCF 09 


218 


inc Rl 








U U JJU '3f lo* 




mov B,#100 








00D3 84 


220 


div AB 








00D4 2430 


221 


add A,#zero 








0OD6 F7 


222 


mov ?R1,A ;store the first digit 



















Figure K-1. Sample Absolute Program (Cont'd.) 
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MCS-51 MACRO ASSEMBLER 



01/14/86 



LOC 


OBJ 


LINE 






223 


O0D7 


09 


224 


00D8 


E5F0 


225 


00DA 


75F00A 


226 


OODD 


84 


227 


OODE 


2430 


228 


OOEO 


F7 


229 






230 


00E1 


E5F0 


231 


00E3 


2430 


232 


0OE5 


F7 


233 






234 


0OE6 


22 


235 






235 






237 



; Factor out the second digit 
inc Rl 



mov 
mov 
div 
add 
mov 



B,#10 
AB 



; store the second digit 



A, #zero 

em, a 

Store the third digit 
mov A, B 
add A, (zero 

mov SRI, A ; store the third digit 

note that we return without restoring Rl 
ret 



; 



MCS-51 MACRO ASSEMBLER SAMPLE 
SYMBOL TABLE LISTING 



NAME 


T 


Y P E 


V A L 


U 


E 


ACC 


D 


A DDR 


00E0H 




A 


ASCBIK . . . 


C 


ADDR 


009FH 




A 


B 


D 


ADDR 


0OFOH 




A 


BINASC . . . 


C 


ADDR 


O0C5H 




A 


CR 




NUMB 


000DH 




A 


EXIT .... 


C 


ADDR 


0071H 




A 


GET CHAR . . 


c 


ADDR 


0097H 




A 


GET LOOP . . 


c 


ADDR 


0086H 




A 


GET NUM. . . 


c 


ADDR 


0082H 




A 


GO ON ■ . . . 


c 


ADDR 


0092H 




A 


GO ON2 . . . 


c 


ADDR 


00CFH 




A 


LF 




NUMB 


00AH 




A 


MINUS. . . . 




NUMB 


002DH 




A 


NUM1 MSG . . 


c 


ADDR 


0BD3H 




A 


NUM1 .... 


D 


ADDR 


0030H 






NUM2 MSG . . 


c 


ADDR 


OBEAH 




A 


NUM2 .... 


D 


ADDR 


0034H 




A 


PLUS .... 




NUMB 


002BH 




A 




C 


ADDR 


0OC2H 




h 


PUT CHAR . . 


c 


ADDR 


007AH 




A 


PUT_CRLF . . 


c 


ADDR 


005AH 




A 


PUT_DATA STR 


c 


ADDR 


0072H 




A 


PUT_STRING . 


c 


ADDR 


0067H 




A 




B 


ADDR 


0098H 





A 


SAMPLE . . . 












SBUF .... 


D 


ADDR 


0099H 




A 


SCON .... 


D 


ADDR 


0098H 




A 


SIGN .... 


B 


ADDR 


00E0H 


7 


A 


STACK. . . . 


D 


ADDR 


0008H 




A 


START. . . . 


C 


ADDR 


000BH 




A 


SUM MSG. . . 


C 


ADDR 


0C02H 




A 







ADDR 


0038H 




A 


TEMP .... 




REG 


R3 








D 


ADDR 


008DH 




A 


TI 


B 


ADDR 


0098H 


1 


A 


TMOD .... 


D 


ADDR 


0089H 




A 


TR1 


B 


ADDR 


0088H 


6 


A 


TYPO MSG . . 


C 


ADDR 


OBBBH 




A 


ZERO .... 




NUMB 


0030H 




A 



ATTRIBUTE 



REGISTER BANK ( S ) USED 
ASSEMBLY COMPLETE, NO 








Figure K-1. Sample Absolute Program (Cont'd.) 



Selecting a Target Processor 




Members of the MCS-51 family of microprocessors have the same basic architecture 
and instruction set. However, they differ in the definition of their special function 
registers. ASM51 is distributed with Processor Definition Files (PDF's) for members 
of the MCS-51 family. Each PDF file contains definitions of the special function 
registers of one member. These files are named REGxx.PDF, where xx is the proces- 
sor number (e.g.. REG44.PDF, REG52.PDF). 

The PDF files contain ASM51 source lines — BIT and DATA directives. In order to 
use a PDF file, you should INCLUDE it in your program. ASM51 will treat it just 
like any other INCLUDE file. You should, however, use the primary control 
NOMOD51 in such cases. 

To preserve compatubility with previous ASM 5 1 versions, the primary control MOD5 1 
has been added. When MOD5I (the default) is in effect, the assembler recognizes 
the predefined names of the special function registers of the 8051 microprocessor. If 
you want to use the special registers of another MCS-5 1 family processor, you should 
specify NOMOD5I and then INCLUDE the appropriate PDF file. For example, to 
assemble a program written for use on the 8044. first specify NOMOD51 in a primary 
control line (or in the invocation line), and then INCLUDE the file REG44.PDF. 

NOTE 

If you fail to specify NOMOD51, all of the 8051 special function registers 
are recognized by the assembler. If you then INCLUDE a PDF file, you will 
be trying to redefine some of the special function registers (e.g., PSW. ACC). 
For each redefinition attempt, the assembler will issue an error message. 

Because a PDF file merely contains ASMS I source lines that use BIT and DATA 
directives to define the special function registers, you can modify the PDF file if you 
like. Thus, if you prefer different symbol names, you can change them in the PDF. 
Or if a new version of the 8044 with additional special registers is made, you can 
simply add the definitions of these registers to your REG44.PDF file. 



r 




Index 



A (accumulator), 1-12, 2-2 
absolute segments, 1-3 
AC (auxiliary carry flag), 1-7, 1-13, 2-7 
ACALL code address, 3-4, 3-5, B-2, 

B-9-B-13 
ACC (accumulator), 1-12, 1-13 
see also CALL, 3-24 

LCALL, 3-69, 3-70 
ADD 

arithmetic function, 1-10 

A,§data, 3-6, B-2, B-9 

A,@Rr, 3-7, B-2, B-9 

A,Rr, 3-8, B-2, B-9 

A,data address, 3-9, B-2, B-9 
ADDC 

arithmetic function, 1-10 

Ajdata, 3-10, B-2, B-9 

A,@Rr, 3-11, 3-12, B-2, B-9 

A,Rr, 3-13, B-2, B-9 

A,data address, 3-14, B-2, B-9, B-10 
address, data unit, 1-9, 1-10 
AJMP code address, 3-15, B-2, B-9-B-12 

see also In-Block Jumps and calls, 2-8 
JMP, 3-59 
LJMP, 3-71 
SJMP, 3-122 
ANL 

AJdata, 3-16, B-2, B-10 
A,@R/-, 3-17, B-2, B-10 
A,Rr, 3-18, B-2, B-10 
A,data address, 3-19, B-2, B-10 
C,bit address, 3-20, B-2, B-l 1 
C,l bit address, 3-21, B-2, B-l 1 
data address, #data, 3-22, B-2, B-10 
data address, 3-23, B-2, B-10 
logical function, 1-10 

Arithmetic and Logic Unit, 1-7, 1-10 

ASCII Characters 
in strings, 2-10, 4-8 
Codes, H-l 

ASM51 invocation, 1-4-1-6 

assembler, 1-1 



assembler (ASM51), 1-3 
assembler controls, 1-1 
assembler directives, 1-1, 4-1 
assembler state controls, 4-1, 4-10 
assembly-time expressions, 2-1 
ATTRIBUTES, 7-20 

B (multiplication register), 1-7, 1-12 
binary numbers, expressing, 2-9 
BITADDRESSABLE, 4-4 
bit addressing, 1-14, 2-1, 2-5-2-7 
bit address space, 1-8, 1-9, 2-6 
bit, data unit, 1-9 

BIT directive, 2-1, 2-5, 2-11, 4-1, 4-5, 4-10, 

6-8, C-l, L-l 
bit selector ("."), 1-13, 2-5 
BNF, A-l 

Boolean functions, 1-7 
see also ANL, 3-20, 3-21 

CLR, 3-34, 3-35 

CPL, 3-37, 3-38 

JB, 3-53, 3-54 

JBC, 3-55, 3-56 

JC, 3-57, 3-58 

JNB, 3-61, 3-62 

JNC, 3-63, 3-64 

MOV, 3-79, 3-84 

ORL, 3-106, 3-107 

SETB, 3-120, 3-121 
bracket function, 5-9, E-l 
BSEG directive, 4-1, 4-11, C-l 
byte, data unit, 1-9 

C, 2-2 

CALL code address, 3-24 
see also ACALL, 3-4, 3-5 

LCALL, 3-69, 3-70 
call-pattern, 5-2, 5-3, 5-5 
character strings in expressions, 2-10, 2-1 1, 
4-8, 4-9 
see also ASCII, H-l 
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CJNE 

@Kr,#data address, 3-25, 3-26, B-3, B-12 
\,§data,code address, 3-27, 3-28, B-3, 
B-12 

A,data address,code address, 3-29, 3-30, 
B-3, B-12 

Rr,#data,code address, 3-31, 3-32, B-3, 
B-12 

CLR 

A, 3-33, B-3, B-12 

C, 3-34, B-3, B-12 

bit address, 3-35, B-3, B-12 
code addressing, 2-1, 2-7, 2-9 
code address space, 1-8 
CODE directive, 2-1, 2-11, 4-1, 4-3, 4-7, 
4-10 

comment function, 5-8, E-l 

commercial at sign @, 2-3 

conditional assembly, 5-2 

console I/O built-in macro, 5-18, E-l 

control line, 6-2, A-2 

conversion to hexadecimal format, 1-4 

CPL 

A, 3-36, B-3, B-13 

bit address, 3-38, B-3, B-l 1 

C, 3-37, B-3, B-l 1 

logical function, 1-10 
CSEG directive, 4-1, 4-11, C-l 
CY (carry nag), 1-13. 2-7 

DA (control) see DATE control 
DA 

arithmetic function, 1-10 

A, 3-39, B-3, B-12 
data addressing, 2-4, 2-5 

on chip, 2-1 
data address space, 1-8, 1-9 
DATA directive, 2-1, 2-11, 4-1, 4-3, 4-6, 

4-10, 6-8, C-l, L-l 
Data Pointer (DPTR), 1-10, 2-2 
DATE control, 6-2, 6-4, D-l 
DB (control) see DEBUG control 
DB directive, 4-1, 4-8, C-l 
DBIT directive, 4-1, 4-7, 4-8, C-l 



DEBUG control, 1-3, 6-2, 6-4, D-l 

Debugging, 1-2 

DEC 

arithmetic function, 1-10 

@Rr, 3-40, B-3, B-9 

A, 3-41, B-3, B-9 

Rr, 3-42, B-3, B-9 

data address, 3-43, B-3, B-9 
decimal numbers, expressing, 2-9 
DEFINE, 5-2-5-7, E-l 
delimiters, 5-18-5-21 
directives 

assembler, 4-1-4-12, C-l 

end of program, 4-10 

location counter control, 4-7, 4-8 

symbol definition, 4-3-4-7 
DIV 

arithmetic function, 1-10 
AB, 3-44, B-3, B-l 1 
DJNZ 

Rr,code address, 3-45, B-4, B-12 

data address,code address, 3-46, 3-47, 
B-4, B-12 
dollar sign ($), 4-2 
DPH, 1-7, 1-12 

see also Data Pointer, 2-2 
DPL, 1-7, 1-12 

see also Data Pointer, 2-2 
DPTR see Data Pointer, 2-2 
DS directive, 4-1, 4-7, C-l 
DSEG directive, 4-1, 4-1 1, C-l 
DW directive, 4-1, 4-8, 4-9, C-l 

EA (Enable All Interrupts), 1-16, 2-7 
EJ see EJECT 
EJECT control, 6-2, 6-5, D-l 
END directive, 4-1, 4-10, C-l 
EP see ERRORPRINT control 
EQS built-in macro, 5-12, 5-13, E-l 
EQU directive, 4-1, 4-4, 4-5, 4-12, C-l 
error messages 

console, printed at, 7-1 

fatal, 7-2 

internal, 7-2 
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I/O, 7-1 
listing file, printed in, 7-4-7-15 

control, 7-13, 7-14 

fatal, 7-15 

macro, 7-10-7-12 

source, 7-4—7-10 

special, 7-14 
ERRORPRINT control, 6-2, 6-5, D-l 
ES (Enable Serial port interrupt), 1-16, 2-7 
ESCAPE macro function, 5-9, E-l 
ETO (Enable Timer interrupt), 1-16, 2-7 
ET1 (Enable Timer 1 interrupt), 1-16, 2-7 
EVAL built-in macro, 5-1 1, 5-12, E-l 
EXO (Enable external interrupt 0), 1-16, 2-7 
EX1 (Enable external interrupt 1), 1-16, 2-7 
EXIT built-in macro, 5-15, E-l 
EXTIO, 1-16 
EXTI1, 1-16 

extensions of filenames, 1-4 
external data address space, 1-8 
EXTRN directive, 4-1, 4-9, 4-10, C-l 

F0, 1-7, 1-13, 2-7 
function, built-in macro, 5-2 

GE see GEN 
GEN 

control, 6-2, 6-6, D-l 
general relocatable expressions, 2-16 
generic call, 2-9 
generic jump, 2-9 
GENONLY 

control, 6-2, 6-6, D-l 
GES built-in macro, 5-12, 5-13, E-l 
grammar, language, A-l 
GO see GENONLY 
GTS built-in macro, 5-12, 5-13, E-l 

see also DATE, 6-4 
TITLE, 6-12 

hardware, 1-6 
hexadecimal, 2-9 



IC see INCLUDE control 

IDATA Directive, 2-1, 2-4, 2-1 1, 4-1, 4-3, 

4-6, 4-10 
IDATA space, 2-3 

IE (Interrupt Enable), 1-7, 1-12, 1-15, 1-16 

IE0 (Interrupt Edge flag), 1-14, 2-7 

IE1 (Interrupt 1 Edge nag), 1-14, 2-7 

IF (built-in macro), 5-13, 5-14, E-l 

immediate data(#), 2-1, 2-3 

INBLOCK, 4-4 

in-block jumps, 2-8 

IN built-in macro, 5-18, E-l 

INC 

arithmetic function, 1-10 

@Rr, 3-48, B-4, B-9 

A, 3-49, B-4, B-9 

DPTR, 3-50, B-4, B-ll 

Rr, 3-51, B-4, B-9 

data address, 3-52, B-4, B-9 
INCLUDE control, 6-3, 6-6, 6-8, D-l, L-l 
indirect addressing (@), 1-9, 2-1-2-3 
INPAGE, 4-4 
instruction cycle, 1-7 
INTO (Interrupt input pin), 1-15, 2-7 
INT1 (Interrupt 1 input pin), 1-15, 2-7 
internal data address space, 

directly addressable, 1-8 

indirectly addressable, 1-8 
interrupt 

control, 1-15-1-17 

priority, 1-6 
invocation line, 6-1 
invocation line errors, 7-1-7-3 
I/O port, 1-6 

IP (Interrupt Priority), 1-7, 1-12, 1-15, 1-16 
ISEG, 4-1,4-11 

IT0 (Interrupt Type control bit), 1-14, 2-7 
IT1 (Interrupt 1 Type control bit), 1-14, 2-7 

JB bit address,code address, 3-53, 3-54, B-4, 
B-9 

JBC bit address,code address, 3-55, 3-56, 
B-4, B-9 
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JC code address, 3-57, 3-58, B-4, B-10 
JMP code address, generic, 3-59 
JMP @ + DPTR, 3-60, B-4, B-10 
JNB bit address,code address, 3-61, 3-62, 
B-4, B-9 

JNC code address, 3-63, 3-64, B-4, B-10 
JNZ code address, 3-65, 3-66, B-4, B-10 
JZ code address, 3-67, 3-68, B-5, B-10 

label, 4-2, 4-3 

LCALL code address, 3-69, 3-70, B-5, B-9 
see also ACALL, 3-4, 3-5 
CALL, 3-24 
LEN built-in macro, 5-16, E-l 
LES, 5-12, 5-13, E-l 
LI see LIST 

LIST control, 6-3, 6-7, D-l 
listing file, 1-4 

format, 7-15-7-17 

heading, 7-18 

literal character (*), 5-2, 5-21, 5-22 
listing file trailer, 7-21 
LJMP code address, 3-71, B-5, B-9 
see also AJMP, 3-15 
JMP, 3-59 
SJMP, 3-122 
local-symbol-list, 5-2, 5-6, 5-7, E-l 
location counter ($), 2-12, 4-2 

symbol, 2-2 
long jumps or calls, 2-8 
see also LCALL, 3-69, 3-70 
LJMP, 3-71, 3-72 
LTS, 5-12, 5-13, E-l 

machine instructions, 1-1 
macro 

arithmetic expressions in, 5-1 1, E-3 

—body, 5-2, 5-3, 5-7 

built-in, 5-2 

delimiters, 5-18-5-21 

expressions, 5-10 

identifier, 5-3 

listing format, 7-15-7-18 



parameters, 5-5 

—time, 5-2 
MACRO control, 6-3, 6-7, D-l 
MO see MOD 51 control 
MOD51 control, 6-3, 6-8, L-l 
MATCH built-in macro, 5-17, E-l 
memory addresses, 1-8 
METACHAR built-in macro, 5-10, E-l 
metacharacter ($nl), the, 5-2 
modular programming, 1-2 
module, 1-3 

monolithic programs, 1-2 
MOV 

@Rr,#data, 3-72, B-5, B-10 
@Rr,A, 3-73, B-5, B-13 
@Rr,data address, 3-74, B-5, B-l 1 
KUata, 3-75, B-5, B-10 
A,@Rr, 3-76, B-5, B-l 2 
A,Rr, 3-77, B-5, B-l 2 
A,data address, 3-78, B-5, B-l 2 
C,bit address, 3-79, B-5, B-l 1 
DPTR,#data, 3-80, B-5, B-l 1 
Rr,#data, 3-81, B-5, B-l 1 
Rr,A, 3-82, B-5, B-13 
Rr,data address, 3-83, B-5, B-l 1 
bit address, C, 3-84, B-5, B-l 1 
data adress,§data, 3-85, B-5, B-10 
data address,@Rr, 3-86, B-5, B-l 1 
data address, A, 3-87, B-5, B-13 
data address,Rr, 3-88, B-6, B-l 1 
data address,data address, 3-89, B-6, 
B-l 1 
MOVC 

A,@A + DPTR, 3-90, B-6, B-l 1 
A,@ + PC, 3-91, 3-92, B-6, B-l 1 

MOVX 

@DPTR,A, 3-93, B-6, B-13 
@Rr,A, 3-94, 3-95, B-6, B-13 
A,@DPTR, 3-96, B-6, B-l 2 
A,@Rr, 3-97, 3-98, B-6, B-l 2 

MPL, 5-1 

MR see MACRO control 
MUL 
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arithmetic function, 1-10 
AB, 3-99, 3-100, B-6, B-ll 

NAME directive, 4-1, 4-10, 7-18, 7-20 
NES, 5-12, 5-13, E-l 
nibble, data unit, 1-9 
NODB see NODEBUG control 
NODEBUG control, 6-2, 6-4, D-l 
NOEP see NOERRORPRINT control 
NOERRORPRINT control, 6-2, 6-5, D-l 
NOGE see NOGEN control 
NOGEN control, 6-2, 6-6, D-l 

listing format, 7-15-7-18 
NOLI see NOLIST control 
NOLIST control, 6-3, 6-7, D-l 
NOMACRO control, 6-3, 6-7, D-l 
NOMO see NOMOD51 control 
NOMOD51 control, 6-3, 6-8, L-l 
NOMR see NOMACRO control 
NOOBJECT control, 6-3, 6-8, D-l 
NOOJ see NOOBJECT control 
NOP, 3-101, B-6, B-9 
NOPAGING control, 6-3, 6-9, D-l 
NOPI see NOPAGING control 
NOPR see NOPRINT control 
NOPRINT control, 6-3, 6-10, D-2 
NOREGISTERBANK, 6-3, 6-11, D-2 
NOSB see NOSYMBOLS control 
NOSYMBOLS control, 6-3, 6-12, D-2 
NOXR see NOXREF control 
NOXREF control, 6-3, 6-13, D-2 
null string 

assembler, 2-1 1, 4-8 

macro processor, 5-2 
NUMBER, 4-10 
numbers 

specifying, 2-9 

representation of, 2-10 

OBJECT control, 6-3, 6-8, D-l 
object file, 1-3 

OBJHEX code conversion program, 1-4 
octal, 2-9 

OJ see OBJECT control 



operators, assembly-time 

arithmetic, 2-13 

logical, 2-13 

relational, 2-14, 2-15 

special assembler, 2-14 
operator precedence, 2-15 
operators, macro, 5-10 
ORG directive, 4-1, 4-2, 4-1 1, C-l 
ORL 

A,#data, 3-102, B-6, B-10 
A,@Rr, 3-103, B-6, B-10 
A,Rr, 3-104, B-6, B-10 
A,data address, 3-105, B-6, B-10 
C,bit address, 3-106, B-6, B-10 
C,/bit address, 3-107, B-6, B-l 1 
data address, #data, 3-108, B-6, B-10 
data address,K, 3-109, B-6, B-10 
logical function, 1-10 
OUT built-in macro, 5-18, E-l 
OV (overflow flag), 1-7, 1-13, 2-7 

P (parity flag), 1-7, 1-13, 2-7 
PAGING control, 6-3, 6-9, D-l 
PAGELENGTH control, 6-3, 6-9, D-l 
PAGEWIDTH control, 6-3, 6-10, D-l 
PC, 1-7, 1-11, 2-2 

see also program counter, 2-2 
PDF see Processor Definition File 
PI see PAGING control 
PL see PAGELENGTH control 
POP data address, 3-1 10, B-7, B-l 2 
Port (P0) see I/O Port, 1-6 
Port 1 (PI) see I/O Port, 1-6 
Port 2 (P2) see I/O Port, 1-6 
Port 3 (P3), 1-14 

see also I/O Port, 1-6 
poundsign (#), 2-3 
PR see PRINT control 
predefined bit addresses, 2-7 
predefined symbolic register addresses 

(AR0-AR7), 4-12 
PRINT control, 6-3, 6-10, D-2 
Processor Definition File, 6-8, L-l 
program, 1-3 
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program counter, 1-6, 1-9, 2-2 
program linkage, 4-1, 4-9 
program memory, 1-8 
Program Status Word (PSW), 1-13 
PS (Priority of Serial Port Interrupt), 1-16, 
2-7 

PSW see Program Status Word 
PTO (Priority of Timer Interrupt), 1-16, 
2-7 

PT1 (Priority of Timer 1 Interrupt), 1-16, 
2-7 

PUBLIC directive, 4-1, 4-9 
public symbols, 2-16 
PUSH data address, 3-111, B-7, B-12 
PW see PAGEWIDTH control 
PXO (Priority of External Interrupt 0), 1-16, 
2-7 

PX1 (Priority of External Interrupt 1), 1-16, 
2-7 

R0, Rl, R2, R3, R4, R5, R6, R7, 1-11, 2-2 

see also, registers, General-purpose, 1-11 
RAM memory, 1-6 
RD (Read Data external), 1-15, 2-7 
register 

banks, 1-11 

general-purpose, 1-11 

program addressable, 1-12 

special function, 6-8, L-l 

value at reset, 1-17 
register address symbols AR0-AR7, 2-2 

see also USING, 4-12 
REGISTERBANK, 6-3, 6-1 1 
relative jumps, 2-8 
relative offset, 2-8 

relocatable expression evaluation, 2-16 
relocatable object code, 1-3 
relocatable segments, 2-16 
relocatable symbol, 2-16 
relocation and linkage, 1-4 
relocation types, 4-3 
REN (Receive Enable), 1-15, 2-7 
REPEAT built-in macro, 5-15, E-l 
reset, 1-17 



RESTORE control, 6-3, 6-11, D-2 
RET, 3-112, 3-113, B-7, B-9 
RETI, 3-114, 3-115, B-7, B-9 
return value, 5-2 
RL51, 1-4 

RL A, 3-116, B-7, B-9 
RLC A, 3-117, B-7, B-9 
RL-time expressions, 2-1 
RR A, 3-118, B-7, B-9 
RRC A, 3-119, B-7, B-9 
RS see RESTORE control 
RSO (Register Select Bit 0), 1-7, 1-11, 1-13, 
2-7 

RSI (Register Select Bit 1), 1-7, 1-11, 1-13, 
2-7 

RSEG, 4-1, 4-11 

RXD (Serial Port Receive pin), 1-15, 2-7 

SA see SAVE control 

SAVE control, 6-3, 6-1 1 

SB see SYMBOLS control 

SBUF (Serial Port Buffer), 1-7, 1-12 

SCON (Serial Port Control), 1-7, 1-12, 1-15 

scope, 2-1 1 

external, 2-1 1 

local, 2-11 

public, 2-1 1 
segment, 1-2 

SEGMENT directive, 4-1, 4-3 
segment type, 2-1, 2-11, 4-10 

attributes, 4-3 

BIT, 2-1 1 

CODE, 2-11 

conventions, 2-12 

DATA, 2-1 1 

IDATA, 2-1 1 

in expressions, 2-15 

of operands, 2-3-2-5, 2-8, 2-9 

of symbols, 4-4-4-6 

XDATA, 2-11 
segment selection directives, 4-1, 4-1 1 
serial I/O Port, 1-6, 1-7, 1-15 
SETB 

C, 3-120, B-7, B-12 
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bit address, 3-121, B-7, B- 12 
SET built-in macro, 5-11, E-l 
SET directive, 4-1, 4-5, C-l 
simple relocatable expressions, 2-16 
SINT, 1-16 

SJMP code address, 3-122, B-7, B-l 1 
SMO (Serial Mode Control bit 0), 1-15, 2-7 
SMI (Serial Mode Control bit 1), 1-15, 2-7 
SM2 (Serial Mode Control bit 2), 1-15, 2-7 
source listing, 7-18 
SP (Stack Pointer), 1-12, 1-17, 1-19 

see also stack, 1-11 
special assembler symbols, 2-1, 2-2 

see also EQU directive, 4-4, 4-5 
stack, 1-11 
stack segment, 4-4 
statement labels, 4-2 
storage initialization/reservation 

directives (DS, DB, DW, DBIT), 4-1, 4-2, 
4-7-4-9 

SUBB 

arithmetic function, 1-10 
AJdata, 3-123, B-7, B-l 1 
A,@Rr, 3-124, 3-125, B-7, B-l 1 
A,Rr, 3-126, 3-127, B-7, B-l 1 
A,data address, 3-128, 3-129, B-7, B-l 1 
SUBSTR built-in macro, 5-16, 5-17, E-l 
SWAP A, 3-130, B-7, B-l 2 
symbol, 2-11, 4-4 
definition, 4-1-4-3 
names, 4-2 

see also BIT, 4-5 
DATA, 4-6 
EQU, 4-4, 4-5 
SET, 4-5 
XDATA, 4-6 
use of, 2-11, 2-12 
SYMBOLS control, 6-3, 6-12, D-2 

target processor, L-l 
TITLE control, 6-3, 6-12, D-2 
TO (Timer/counter External flag), 1-15, 
2-7 



Tl (Timer/counter 1 External flag), 1-15, 
2-7 

TCON (Timer Control), 1-7, 1-12 
TFO (Timer Overflow Flag), 1-13, 2-7 
TF1 (Timer 1 Overflow Flag), 1-13, 2-7 
THO (Timer high byte), 1-7, 1-12 
TH1 (Timer 1 high byte), 1-7, 1-12 
TIMERO, 1-17 
TIMER1, 1-17 

TLO (Timer low byte), 1-7, 1-12 
TL1 (Timer 1 low byte), 1-7, 1-12 
TMOD (Timer Mode), 1-7, 1-12, 1-14 
TRO (Timer Run control bit), 1-14, 2-7 
TR1 (Timer 1 Run control bit), 1-14, 2-7 
TT see TITLE control 
two-pass assembler, 4-1 
TXD (Serial Port Transmit bit), 1-15, 2-7 
type, 2-11 

address, 2-1 1 

number, 2-1 1 

register, 2-1 1 

segment, 2-1 1 
TYPE, 7-20 
typeless symbol, 4-10 
type "REG", 4-4 

UNIT, 4-4 
UPM, 1-6 
UPP, 1-6 

use of symbols, 2-1 1 

USING directive, 2-2, 4-1,4-12 

value, 2-1 1 

constant value, 2-1 1 

register name, 2-1 1 

segment base address, 2-1 1 

symbol address, 2-1 1 
VALUE, 7-20 

WHILE built-in macro, 5-14, E-l 
words, data unit, 1-9 
WR (write Data for External Memory), 
1-15, 2-7 
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Macro Assembler 



writing, assembling, and debugging an 
MCS 8 -51 Program, 1-4 



XCH 

A,@Rr, 3-131, B-7, B-12 
A,Rr, 3-132, B-7, B-12 
A,data address, 3-133, B-7, B-12 
XCHD A,@Rr, 3-134, 3-135, B-8, B-12 
XDATA directive, 2-1, 2-11, 4-1, 4-3, 4-6, 
4-10 



XR see XREF control 

XREF control, 6-3, 6-13, 7-20, 7-21, D-2 

XRL 

A,#data, 3-136, B-8, B-10 
A,@Rr, 3-137, B-8, B-10 
A,Rr, 3-138, B-8, B-10 
A,data address, 3-139, B-8, B-10 
data addressjdata, 3-140, B-8, B-10 
data address, A, 3-141, B-8, B-10 
logical function, 1-10 
XSEG directive, 4-1, 4-6, 4-11, C-2 



